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Scrapbook+ von der amerikanischen Firma T/Maker ist eine 
anspruchsvolle Windows-Anwendung, die die Möglichkeiten der 
Zwischenablage stark erweitert. 


Eine Einführung in die Theorie der Farbsysteme von Microsoft 
Windows. 


Die Verwendung der Windows-Farbsysteme in der Praxis: Eine 
selbstdefinierte Dialogbox-Steuerung für die Auswahl von Farben 
und Farbsystemen. 


Fenster sind der grundlegende Bestandteil von Windows. In 
diesem Artikel werden die theoretischen Grundlagen der Win- 
dows-Fenster und die Erweiterung der Windows-Fensterklassen 
beschrieben. 


Erstmalig veröffentlicht das Microsoft System Journal das Datei- 
format von MS-Word und gibt Ihnen damit die Möglichkeit, MS- 
Word-Dateien mit eigenen Programmen zu verarbeiten oder 
Dateien für die Bearbeitung durch MS-Word zu erstellen. Mit 
ausführlichem Beispiel in Microsoft C. 


Im zweiten Teil unserer Serie über eine SAA-Benutzeroberfläche 
in C beschreibt Michael Tischer die Abfrage und Verwendung von 
Maus und Tastatur. 


Es wird oft angenommen, daß ein Intel 80286 oder 80386 im Real- 
Modus nur 1 Mbyte ansprechen kann, aber dies ist nicht richtig. 
Eine genaue Betrachtung des Aufbaus dieser Prozessoren zeigt, 
daß es möglich ist, fast 64 Kbyte mehr Speicher zu adressieren. 


Ein Interview mit Ray Kanemori, dem Product Manager von 
QuickBASIC. 


Mit dem Entwicklungstool QuickStep Presentation Manager stellt 
Lauer & Wallwitz einen zum OS/2 Presentation Manager kompa- 
tiblen Window-Manager zur Anwendung unter DOS vor. 


Die Termine des Microsoft-Instituts 

Neue Produkte, Aktuelles 

Neuheiten zu OS/2 und Word 

»Die Speicherverwaltung von DOS« aus PC Intern 
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Windows 


Das Windows-Programm Scrapbook+: 


Eine gelungene Erweiterung der Zwischenablage 


Die Zwischenablage von Windows, das Clip- 
board, ist wahrscheinlich die meistverwendete 
Einrichtung zum Datenaustausch zwischen Win- 
dows-Anwendungen. Mit der Zwischenablage 
kann eine in einem Programm erstellte Kalkula- 
tionstabelle oder Zeichnung einfach in ein ande- 
res Progamm übertragen werden, und zwar ohne 
dazu eine Zwischendatei anlegen zu müssen. 


Windows enthält eine selten genutzte Anwendung, die 
Datei CLIPBRD.EXE zum Betrachten der Zwischenab- 
lage. Dieses Programm erlaubt Ihnen also, den momen- 
tanen Inhalt der Zwischablage anzusehen. Dummerweise 
besitzt es darüber hinaus kaum andere Fähigkeiten. 

Wenn man die Windows-Zwischenablage und den ange- 
schlossenen »Betrachter« eine Weile benutzt hat, bemerkt 
man folgende Einschränkungen: 


» Die Zwischenablage ist auf eine Dateneinheit begrenzt 
(allerdings eventuell in mehreren Formaten). 

» Der aktuelle Inhalt der Zwischenablage kann weder 
gelöscht noch gespeichert werden. 

u Oft wird das erzeugende Programm gebraucht, um seine 
Daten in die Zwischenablage zu bringen. 

» Es gibt kein vom System unterstütztes Hilfsmittel, um 
das Format der Zwischenablage zu manipulieren. 

" Die Formate der Zwischenablagedaten können nicht 
beeinflußt werden. 


Scrapbook + von der amerikanischen Firma T/Maker ist 
eine anspruchsvolle Windows-Anwendung, die entwickelt 
wurde, um einige Einschränkungen der Zwischenablage zu 
überwinden. Da Scrapbook+ als Vermittler zu den Daten 
der Zwischenablage zur Verfügung steht, können Sie gele- 
gentlich gebrauchte Daten in leicht erreichbaren Dateien 
ablegen. Wenn Sie die Daten dann brauchen, sind sie leicht 
durch Einkopieren (paste) aus der Zwischenablage in 
jedem Windows-Programm verfügbar. Durch die automati- 
sche Erzeugung kleiner Darstellungen des Inhalts in einem 
visuellen Index ermöglicht Scrapbook +, schnell seitenweise 
durch Abbildungen und Daten aller Arten zu blättern, und 
sie dann nahezu unverzüglich über die Zwischenablage in 
eine andere Windows-Anwendung zu übertragen. Scrap- 
book+ wurde nach der Methode entwickelt, die wir im 
Artikel »Datenaustausch unter Windows« im Microsoft 
System Journal 11/12 ’88 beschrieben haben. Bild 1 veran- 
schaulicht die Auswahl einer Grafik in Scrapbook+ und 
Bild 2 zeigt, wie dieses »Kunstwerk« in Windows Write 
»eingeklebt« wird. 


Konzepte der Enwicklung 


Hinter jedem Produkt stehen Anforderungen, Ergebnisse, 
Enttäuschungen und Träume - und Scrapbook + bildet da 
auch keine Ausnahme. Die ursprüngliche Produktidee ent- 
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Bild 1: Scrapbook + bieter Anwendern zahlreiche Werkzeuge 
für die Auswahl und Bearbeitung von Bildern. 


stand im Frühjahr 1987 in einer Reihe informeller Gesprä- 
che zwischen uns und der Belegschaft von T/Marker, dem 
Herausgeber von Scrapbook +. 

Ursprünglich als Clip-Art-Manager geplant, entwickelte 
Scrapbook+ sich schnell zu einem umfangreichen Werk- 
zeug zum Speichern und Abfragen von Zwischenablage- 
daten. Ganz am Anfang wollten wir ein einfaches Produkt 
entwickeln, das ebenso leicht zu erlernen wie anschaulich, 
schnell und verläßlich seine sollte. Noch wichtiger, wir 
suchten ein Programm zu schaffen, das die Benutzer für so 
unentbehrlich halten sollten wie etwa die Norton Utilities. 


Ein Werkzeug zum Speichern von Daten 


Eines der Hauptprobleme der Windows-Zwischenablage ist 
ihre flüchtige Natur. Wir wollten dem Benutzer ein Mittel 
an die Hand geben, mit dem er die Daten für späteren 
Gebrauch speichern kann. Anfangs hofften wir, jede Art 
von Daten speichern zu können, aber im Verlauf der Ent- 
wicklung von Scrapbook + beschränkten wir uns auf allge- 
mein genutzte und gut verständliche Formate. 

Außer dem Import von Daten aus der Zwischenablage 
in Scrapbook+ hielten wir es für notwendig, gleiches auch 
direkt von der Diskettte bzw. Platte zu ermöglichen. Die 
Funktionalität würde wesentlich erweitert werden, wenn der 
Anwender noch andere Arten von Informationen im Zugriff 
hätte, von denen einige nicht einmal in Windows erreichbar 
wären. Obwohl wir erkannten, daß dieses Vorhaben die 
Entwicklung einer komplizierten Konvertierungs-Routine 
von einer Datei zur Zwischenablage erfordern würde, fühl- 
ten wir uns fast dazu verpflichtet, um ein vollständiges Pro- 
dukt zu erhalten. 

Nachdem wir die Datenkonvertierung zum Speicherkon- 
zept hinzugepackt hatten, wollten wir auch noch diverse 
weitergehende Mechanismen anbieten, mit denen der 
Anwender seine Zwischenablage und die augenblickliche 
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Bild 2: Ausgewählte Bilder können in andere Windows- 
Anwendungen eingefügt werden. 


Bildschirmanzeige automatisch abspeichern kann. Nach 
einigen Versuchen mündete das Vorhaben in den Funktio- 
nen AutoPaste, ScreenCapture und Camera. 


Das Werkzeug zur Datenabfrage 


Als gelegentliche Benutzer von PageMaker und Microsoft 
Excel waren wir von der Unfähigkeit frustriert, an Dinge 
heranzukommen, ohne die Originalanwendung zu besitzen. 
Wir wollten in der Lage sein, visuell durch eine große 
Menge Text, Zeichnungen und Bilder blättern zu können, 
wenn wir bei der augenblicklichen Arbeit nach einer pas- 
senden Ergänzung suchten. 

Das Erfordernis, die Daten schnell anzusehen und aus- 
suchen zu können, brachte eine Art Daumenkino hervor, 
die Funktion Thumbanails als kleine Stellvertreter einer gan- 
zen Seite von Scrapbook +. Das Konzept des Daumenkinos 
versetzte uns in die Lage, die Informationen zu konzentrie- 
ren und große Datenmengen effektiv darzustellen. Mit dem 
visuellen Index kann man eine spezielle Seite leicht auffin- 
den, die richtige Abbildung leicht auswählen und das resul- 
tierende Format in die Zwischenablage kopieren. 

Da typische Benutzer sicherlich ihre eigenen 
Scrapbook+-Dateien erzeugen wollen, gingen wir davon 
aus, daß sie Zugriff auf die Programme haben, die diese 
Daten produzieren. So entschieden wir uns also, keine 
Werkzeuge zum Editieren mit einzubauen. Nebenbei 
gesagt, einen Editor für alle unterstützten Formate zu ent- 
wickeln würde bedeuten, daß viele Funktionen recht dürftig 
ausfielen. Am Ende haben wir dem Programm dann noch 
einige eingeschränkte Werkzeuge einverleibt, die ermög- 
lichten, einen Ausschnitt aus den Daten zu wählen: zum 
Kopieren in die Zwischenablage oder um eine neue Klein- 
darstellungsform für das Daumenkinos zu erreichen. 

Als weitere Verbesserung der Datenabfrage nach der 
Importierung von Daten direkt von der Platte, hielten wir es 
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Bild 3: Die visuellen Bestandteile eines Scrapbook +-Fensters. 
Mit dem Werkzeugkasten kann man ein Auswahlwerkzeug 
wählen oder die Art der Anzeige einstellen. 


1 Titelleiste 

2 Fensterrahmen 
3 Menüleiste 

4 Vergrößern 


9 Anzeigebereich 

18 Horizontale Scrolleiste 

11 Größeneinstellung Daumenkino 
12 Scrolleiste für Daumenkino 
13 Daumenkino 

14 Sinnbild Zwischenablage 

15 Seitenschieber 

16 Steuerungsmenü 


5 Verkleinern 

6 Beschreibung 

7 Vertikale Scrolleiste 
8 Werkzeugkasten 


für angebracht, ebenso Möglichkeiten zum Export von 
Daten zu schaffen. Eine logische Folgerung dieser Ent- 
scheidung ist, daß die Daten sowohl von der Zwischenab- 
lage als auch von der aktiven Scrapbook + -Datei exportiert 
werden konnten. 


Der Vermittler für Daten 
aus der Zwischenablage 


Von Anfang an gab es einen Punkt am Windows, der uns 
erfreute: die Fähigkeit des einfachen Informationsaus- 
tauschs zwischen verschiedenen Anwendungen. Unser Kon- 
zept für Scrapbook+ erweiterte diese Anschauung derart, 
daß der Datenaustausch zwischen Diskette und Anwendung 
mittels Zwischenablage eingeschlossen wurde, wobei 
Serapbook+ als eine Art Vermittler agierte. Beim Basteln 
an dieser Idee wollten wir erreichen, daß unser Werkzeug 
einige der lästigen Stolpersteine der Zwischenablage umge- 
hen konnte, während es nahtlos ihre Vorteile übernahm. 
Obwohl die momentane Version von Scrapbook + nicht 
direkt die entfernte Abfrage und Übertragung von Daten 
ermöglicht, werden zukünftige Versionen dazu in der Lage 
sein. Mit der Möglichkeit des dynamischen Datenaustauschs 
(DDE), könnten Anwendungen eine spezifische Daten- 
struktur abfragen oder übergeben (submit). Des weiteren 
könnten Anwendungen Scrapbook+ als Werkzeug zum 
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Bild 4: Nur Anzeige des Bildes. 


Konvertieren von und nach verschiedenen Zwischenabla- 
geformaten und externen Diskettendateien benutzen. Auf 
diese Weise wären viele Entwickler von der lästigen Auf- 
gabe befreit, eine ständig wachsende Zahl von Formaten zu 
unterstützen, und könnten sich statt dessen auf die Entwick- 
lung neuer innovativer Anwendungen konzentrieren. 


Visuelle Komponenten 


Scrapbook + wurde ganz besonders als visuelle Anwendung 
entworfen. Die meisten Benutzer gehen visuell auf ein Pro- 
gramm ein, und ihr Verständnis wird wesentlich gesteigert, 
wenn die verwendeten sichtbaren Metaphern die interne 
Wirkungsweise der Anwendung widerspiegeln. 

Beim ersten Start von Scrapbook+ sehen Sie etwa das, 
was in Bild 3 dargestellt ist. Obwohl die meisten Kompo- 
nenten des Scrapbook + -Fensters den erfahrenen Windows- 
Anwendern vertraut sind, erfordern einige jedoch zusätz- 
liche Erläuterungen. (Die Zahlen weisen auf die im Bild 
markierten Komponenten hin.) 

Der Beschreibungskasten (6) zeigt eine Kurzbeschrei- 
bung der aktuellen Seite, inklusive Datum und Zeit, zu dem 
sie der Scrapbook +-Datei hinzugefügt wurde. Der Werk- 
zeugkasten (8) ist ein bewegliches Unterfenster, das die 
Auswahl des augenblicklichen Betrachtungsmodus oder 
eines der vier möglichen Werkzeuge erlaubt. Das Betrach- 
tungsfeld (9) zeigt eine Seite der augenblicklichen 
Scrapbook +-Datei an und ermöglicht die rechteckige Aus- 
wahl eines Teils oder die Wahl mit dem Lasso, um diesen 
Teil in die Zwischenablage zu kopieren. 

Die Größe des Daumenkinos (11) wird mit der Anzahl 
der im Scrapbook +-Fenster angezeigeten Bilderzeilen be- 
stimmt. Die Scrollleiste (12) ermöglicht das unsichtbare, 
also im Betrachtungsfeld nicht angezeigte Blättern. Eine 
Seite im Daumenkino wird durch Anklicken auf das 
Betrachtungsfeld gebracht. Wenn sie die Anzeige des 
Daumenkinos (13) wählen, zeigt der untere Teil des 
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Bild 5: Anzeige von Bild und Daumenkino. 


Scrapbook +-Fensters ein verkleinertes Abbild jeder Seite 
der Datei. Obwohl die Abbilder zu klein sein werden, um 
den Inhalt der Seite im Detail zu sehen, sind sie dennoch 
groß genug, um die Seiten vergleichen zu können bevor eine 
zur gezielten Darstellung in das Betrachtungsfeld geholt 
wird. 


Betrachtungsarten 


Scrapbook+ arbeitet in zwei Betrachtungsarten, dem Zwi- 
schenablage-Modus und dem Datei-Modus. Im Zwischen- 
ablage-Modus kann der Inhalt im Betrachtungsfeld ange- 
zeigt werden. Sobald die Zwischenablage Informationen 
enthält, erscheint ein kleines Rechteck in der Mitte des 
Sinnbilds (14). Wenn die Zwischenablage mehr als ein 
Format enthält, können Sie durch Herunterziehen des Pull- 
Down-Menüs View ein anderes für die Anzeige auswählen. 

Im Zwischenablage-Modus sind bestimmte Optionen 
automatisch verfügbar oder nicht zu erreichen. Man kann 
z.B. den Inhalt der Zwischenablage löschen (um so den 
Speicher zu entlasten), aber die Auswahlwerkzeuge sind nur 
erreichbar, während eine Seite der Datei betrachtet wird, 
nicht aber, wenn man sich die Zwischenablage ansieht. 

Zwischen dem Zwischenablage- und dem Datei-Modus 
kann man durch Anklicken des Seitenschiebers oder durch 
Auswahl der Scrapbook-Option im Pull-Down-Menü Page 
umschalten. Im Datei-Modus sind die meisten Menü-Optio- 
nen erreichbar, um die Daten zu bearbeiten, abhängig von 
den vorgegebenen Beschränkungen des gerade betrachteten 
Formats. 

Der Werkzeugkasten wird gebraucht, um ein Auswahl- 
werkzeug zu wählen oder den aktuellen Betrachtungsmodus 
zu ändern. Die Auswahlwerkzeuge werden auf der linken 
Seite und die Modus-Werkzeuge auf der rechten Seite 
angezeigt. Vier Auswahlwerkzeuge stehen zur Verfügung: 
der Kasten (block) zur Auswahl rechteckiger Ausschnitte 
des Betrachtungsfeldes, das Lasso zur Auswahl willkürlicher 
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Bild 6: Nur Anzeige des Daumenkinos. 


Formen, das schnelle Blättern (scroll) im Betrachtungsfeld 
und die Kamera zum Festhalten rechteckiger Bildschirm- 
ausschnitte in der Zwischenablage. 

In jeder der drei Betrachtungsoptionen des Datei- 
Modus sind nur zwei verschiedene Modus-Werkzeuge ver- 
fügbar. Durch Anklicken des gewünschten Modus im Werk- 
zeugkasten verändert sich die Betrachtungsart. Bild 4 zeigt 
Scrapbook+ im Modus »Nur Seite«, Bild 5 zeigt Scrap- 
book+ im Betrachtungs-Modus »Seite & Daumenkino« 
und Bild 6 zeigt den Modus »Nur Daumenkino«. 


Der Umgang mit Scrapbook + 


Scrapbook + sollte auf die gleiche Weise zu bedienen sein 
wie jede andere Windows-Anwendung auch. Wenn Sie das 
Programm starten, verwendet es automatisch die Datei 
SCRAP.ART. Eine neue Datei kann jederzeit durch Aus- 
wahl der Option New im Pull-Down-Menü File erzeugt 
werden. Sie können dabei in der sich öffnenden Dialogbox 
die maximale Anzahl Seiten der erzeugten Datei und die 
gewünschte Größe des Daumenkinos angeben (Bild 7). Es 
ist wichtig, die Größe jedes Daumenkinos angeben zu kön- 
nen, da Windows eine Menge verschiedener Bildschirm- 
arten unterstützt. 

Wurde erst einmal eine Datei erzeugt, kann man die 
Standard-Bearbeitungsfunktionen benutzen: Ausschneiden 
(Cut), Kopieren (Copy), Einkleben (Paste) und Löschen 
(Erase). Im Datei-Modus wirken sie auf die gerade ausge- 
wählte Seite, alle Ablagen eingeschlossen. 

Um mehr Flexibilität zu erreichen, haben wir diese 
standardmäßigen Bearbeitungsfunktionen um spezielle 
Bearbeitungsbefehle erweitert. Die Optionen des Menüs 
Special Edit sind normalerweise versteckt und können nur 
erreicht werden, wenn das Edit-Menü bei gedrückter 
[Shift)-Taste gewählt wird. Die Standardoptionen Cut, 
Copy, Paste und Erase ändern sich in Cut Special, Copy 
Special, Paste Special und Erase Special. Durch Auswahl 
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Bild 7: Im New-Dialogfeld können die Standardwerte einge- 
stellt werden. 


einer dieser Funktionen wird eine Dialogbox mit den ver- 
fügbaren Formaten angezeigt (Bild 8), um die für die Ope- 
ration geeignete einzustellen. 

Die Eigenschaft des AutoPaste bezieht sich auf die 
Standard-Bearbeitungsfunktionen. Wird sie eingeschaltet, 
dann kommen automatisch alle Veränderungen der Zwi- 
schenablage in die aktuelle Scrapbook +-Datei. Als nütz- 
lichen Nebeneffekt kann man damit ein Protokoll aller Ver- 
änderungen der Zwischenablage erhalten oder eine Reihe 
von Bearbeitungsbefehlen aufzeichnen, um z.B. große 
»Blätter« mit Raster-Bildern in einzelne Bilder (Bitmaps) 
zu zerlegen. 

Eine andere Eigenschaft, oft genutzt in Verbindung mit 
der Funktion AutoPaste, ist die Fuktion ScreenCapture. Mit 
ScreenCapture kann der Arbeitsbereich, ein Fenster, das 
ganze Fenster oder auch der ganze Bildschirmbereich in 
Form einer Bitmap in die Zwischenablage kopiert werden. 
Mit der Tastenkombination wird der Vorgang 
eingeleitet, und bei eingeschaltetem AutoPaste kann man 
leicht Bildschirmabbildungen einfangen, auch Pull-Down- 
Menüs, sogar wenn Scrapbook+ auf dem Bildschirm zu 
sehen ist (Bild 9). 

Eine andere Methode, Bildschirmabbildungen einzufan- 
gen, liefert die »Kamera«. Mit ihr läßt sich ein rechteckiger 
Bereich des Bildschirms auswählen und in die Zwischenab- 
lage kopieren, woraus sie dann in die aktuelle Datei ge- 
bracht werden kann. Das ist insbesondere für Entwickler, 
aber auch für Anwender nützlich, da die Kamera erlaubt, 
alles auf dem Bildschirm sichtbare einzusammeln. 

Außer den Standard-Bearbeitungsfunktionen erlauben 
Ihnen die Import- und Exportfähigkeiten von Scrapbook+, 
Daten zwischen der aktuellen Datei oder der Zwischenab- 
lage und der Diskette zu übertragen. Auf diese Weise kann 
eine begrenzte Anzahl Konvertierungen zwischen den Stan- 
dardformaten der Zwischenablage und einigen gängigen 
Dateiformaten durchgeführt werden (Tabelle I). 


Format Block Lasso Scroll Import Export 
Text b) txt xt 
Rich Text a rtf rtf 
Bitmap ® 5 " msp,bmp msp,bmp 
Drucker-Bitmap B E a msp,bmp 
Grafik a wmf wmf 
Druckergrafik u wmf 
CSV “ csv csv 
SYLK & syk syk 
DIF D) dif dif 
TIFF u tif tif 
PostScript b) eps,ps eps,ps 


Tabelle 1A: Nicht für jedes Format der Zwischenablage sind 
alle Werkzeuge verfügbar. 


txt Nahezu alle Textprogramme 
rtf Viele Texverarbeitungsprogramme 


msp Windows Paint 
bmp Windows Bitmap-Editor 
wmf Einige Zeichenprogramme 


Csv Die meisten Tabellenkalkulationen und Datenban- 
ken 

sik Microsoft Excel, Multiplan 

dif Die meisten Tabellenkalkulationen und Datenban- 


ken 
tif Scanner, andere Anwendungen 
eps Adobe Illustrator 


ps Adobe Illustrator 


Tabelle 1B: Die Dateitypen einiger üblicher Quellen, die von 
Scrapbook + unterstützt werden. 


Eine für Windows-Entwickler interessante Sache ist die 
Unterstützung des BMP-Dateiformats. Mit Scrapbook + 
kann man große Bitmap-Bibliotheken erhalten (größere als 
die vom Icon-Editor unterstützten) und man kann ausge- 
wählte zur Einbindung in die Recourcen-Datei einer 
Anwendung exportieren. 

Eine der sehr nützlichen Funktionen von Scrapbook + 
heißt Merge (Bild 10) mit der man Teile oder komplette 
Scrapbook+-Dateien in anderen Dateien kombinieren 
kann. Das ist besonders hilfreich, wenn große Dateien aus 
vielen kleinen zusammengesetzt werden sollen. 


Herausforderungen bei der Entwicklung 


Ein Programm wie Scrapbook+ in einer neuen und her- 
ausfordernden Umgebung wie Windows zu entwickeln, 
bedeutete, auf viele interessante und schwierige Probleme 
zu stoßen. Eine der größten Herausforderungen bei der 
Entwicklung war, schnellen Zugriff auf eine große Anzahl 
Seiten zu ermöglichen, ohne unverschämt viel Speicher zu 


Ei scrapbook+ - SCREEN. ARBEIT 


File Edit View Page Tools 
[20.02.89 17:55] 


Scrapbook+ Cut Special... 


Select one or more formats you wish to 
cut to the clipboard: 


Diitnass 

D Pictures 

DO Texr 
ÜDTIFF Inages 
D Postsoript 
Dich Text 


DPrinter Birmaps 
DPriater Pictures 
Dsvik 

Desv 

Doır R 


Bild 8: Im Dialogfeld Special Edits wird das Format für das 
Auschneiden und Kopieren in die Zwischenablage eingestellt. 


nutzen. Jede Scrapbook +-Datei besteht aus einem Header 
mit fester Länge, gefolgt von einem Index mit variabler 
Größe mit einem Eintrag je Seite, gefolgt von den Daten 
der Seiten selbst. Um schnellen Zugriff zu erreichen, halten 
wir den Header und den Index im Speicher. Eine 500- 
Seiten-Datei benötigt weniger als 8 Kbyte Speicher. 

Die Fähigkeit, eine Datei auf schnelle Weise »grafisch 
durchzulesen«, war eine andere wichtige Forderung beim 
Entwurf, die zu dem Konzept des Daumenkinos führte. 
Zuerst entschieden wir, daß das Daumenkino beim Einfü- 
gen einer Datei erzeugt und auf Diskette geschrieben wer- 
den sollte. Wir wollten das Daumenkino schnell anzeigen 
und dennoch Hauptspeicher erhalten. Unsere Lösung des 
Problems war die Benutzung entfernbarer Bitmaps für das 
Daumenkino. Windows kann sie dann bei Speicheranforde- 
rungen entfernen, und es ist trotzdem ein schnelles Blättern 
im Daumenkino möglich, besonders beim Zurückblättern 
auf Abbildungen, die ins Daumenkino eingelesen und noch 
nicht entfernt wurden. 


System-Abhängigkeiten 


Ein großer Vorteil der Windows-Umgebung ist ihre Unab- 
hängigkeit von den benutzten Geräten. Obwohl die für 
Windows entwickelte Software auf vielen Bildschirmen und 
unter unterschiedlichsten Speicherkonfigurationen läuft, 
inklusive auf Rechnern mit Expanded Memory, ist der Pro- 
grammierer nicht vollkommen unabhängig. 

Scrapbook+ mußte getestet und auf die gebräuchlich- 
sten Monitore und Computer-Konfigurationen eingestellt 
werden, um sicherzustellen, daß jede Ressource die passen- 
den Eigenschaften hatte und die Speicherverwaltung kor- 
rekt arbeitete. Auch mußte eine umfassende Fehler- 
behandlung eingebaut werden, um Situationen in den Griff 
zu bekommen, in denen der Videoadapter nicht kompatibel 
zu den von Scrapbook + verwalteten Daten war. 
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| Sorapbook+ - SCREEN. ART 191%] 
File Edit View Page Tools 
[re 


20.02.89 17:55 


Datei Bearbeiten 


Bild 9: Mit Scrapbook + können der ganze Bildschirm, das 
aktive Fenster oder der Anzeigebereich des aktuellen Fensters 
gespeichert werden. 


Die Entwicklung von Scrapbook+ begann unter der 
Windows-Version 1.03; später haben wir die Version 2.03 
benutzt. Der Wechsel von den nebeneinander liegenden 
Fenstern zu den überlappenden erforderte einige Änderun- 
gen unseres Entwurfs. Auch bestärkte uns die formale Defi- 
nition der Tastatur-Hooks und die Unterstützung des 
Expanded Memory, bedeutende Änderungen an der Funk- 
tion Screen Capture vorzunehmen. Das schloß die Ent- 
wicklung einer dynamischen Link-Bibliothek für unseren 
Tastatur-Hook der Screen Capture-Funktion ein, um die 
Auslagerung unter dem Expanded Memory zu verhindern. 


Vielfältigkeit der Formate 


Unser ursprüngliches Entwicklungsziel bei Scrapbook + war 
es, jeden Datentyp der Zwischenablage behandeln zu kön- 
nen. In der Praxis erwies sich dies als sehr schwierig und in 
einigen Fällen sogar als unmöglich. Einige Formate der 
Zwischenablage wie die Besitzeranzeige und verschiedene 
Eigentümer-Formate hatten nun mal keine Bedeutung ohne 
den Zusammenhang mit dem Programm, das sie in die Zwi- 
schenablage kopierte. Andere Formate wie Text, Bitmaps 
und Metadateien bildeten die Grundlage für den Daten- 
austausch mit der Windows-Zwischenablage, und es 
bestand nie ein Zweifel über ihre Nützlichkeit. 

In der frühen Entwicklungsphase von Scrapbook+ ver- 
pflichteten wir uns selbst, Encapsulated PostScript (EPS) zu 
unterstützen. Da wir die ersten waren, die mit diesem For- 
mat umgingen, mußten wir ein Standardprotokoll für den 
Austausch von EPS-Bildern über die Zwischenablage defi- 
nieren. Für diejenigen, die nicht mit diesem Format vertraut 
sind: EPS besteht aus einer Kombination von PostScript- 
Text mit einer optionalen Anzeige-Beschreibung des Bildes, 
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Serapbook+ - SCRAP.ARTRIENZ 
Eile Edit View Page Tools 
[Bitmap ClickArt. |08. 03.88 20:50] 


Merge Options 
® Merge all 
O Merge fron ß.] to ß3_] 


Note: 493 empty pages available 


Bild 10: Mit dem Befehl Merge können Teile einer Scrap- 
book+-Datei oder auch die ganze Datei in einer anderen 
Datei gespeichert werden. 


die eine Metadatei, eine TIFF-Datei (Tagged Image File 
Format) oder PICT-Datei vom Macintsoh sein kann. 

Unsere Verpflichtung gegenüber EPS führte uns zur 
Unterstützung von TIFF, etwas, was wir im Innersten hoff- 
ten, vermeiden zu können, da es das Projekt bedeutend ver- 
zögern konnte. Jedoch wurde, einmal abgesehen von der 
Komplexität dieses Formats, die Unterstützung von EPS 
und TIFF zum wichtigsten Verkaufsargument des Pro- 
gramms - das hatten wir nicht vorausgesehen. 


Zusammenspiel mit Anwendungen 


Eine Phase der Entwicklung, die mehr Zeit in Anspruch 
nahm als wir gedacht hatten, war das Zusammenspiel von 
Scrapbook+ und anderen Windows-Programmen. Viele 
Spitzfindigkeiten und Verflechtungen von Windows kamen 
in diesem Bereich zu Tage. Wir lernten viel über die Kor- 
rekte Benutzung der Zwischenablage, indem wir sicher- 
stellten, daß Scrapbook + mit vielen anderen Windows-Pro- 
grammen richtig zusammenarbeitete, inklusive Microsoft 
Excel, Aldus PageMaker und Micrografx Designer. 

Wir waren der Ansicht, die Anwender würden immer 
stärker danach verlangen, daß Programme nicht nur für sich 
allein gut laufen, sondern auch im Zusammenspiel mit 
anderen Anwendungen. Deshalb haben wir viel Zeit darauf 
verwandt, das Zusammenspiel zwischen Scrapbook+ und 
den anderen wichtigen Windows-Programmen zu studieren, 
wobei wir besonderes Augenmerk auf die Zusammenarbeit 
mit der Zwischenablage und den Speicherverbrauch hatten. 

Am Ende, und nicht unerwartet, arbeitete Scrapbook + 
beträchtlich besser, als wir alle Codesegmente, auch 
_TEXT, kleiner als 8 Kbyte hielten und die Datensegmente 
auf ein Minimum reduzierten. 


Optimierung der Performance 


Da wir Scrapbook+ als eine System-Utility sahen, die fast 
zu jeder Zeit auf dem Rechner gegenwärtig sein würde, 
unternahmen wir einige Anstrengungen, um die Leistung 
des Programms zu bestimmen und in bestimmten kritschen 
Punkten zu verbessern. 

Wir haben sowohl statische als auch dynamische 
Modelle mit verschiedenen selbstentwickelten Code-Analy- 
setechniken benutzt, um der Anwendung ein gutes mathe- 
matisches Modell zugrundezulegen. Dies Modell wurde 
optimiert und alle Kraft auf die kritischen Bereiche kon- 
zentriert. Das Ergebnis war einen beträchtlich verbesserte 
Anwendung mit ausgeglichenen Segmenten. In bestimmten 
Situation wurde die für einige Operationen benötigte Zeit 
um den Faktor fünf reduziert. 


Entwicklungswerkzeug 


Während der Arbeit an Scrapbook+ haben wir das Pro- 
gramm extensiv als Enwicklungswerkzeug für die Behand- 
lung von Bitmaps, Cursorn und Sinnbildern herangezogen. 
Jede Verkörperung dieser Ressourcen wurde zum Betrach- 


bi 


ten und zum möglichen Einsatz in einer einzelnen Datei 
abgespeichert. Mit dem Daumenkino konnten wir die letz- 
ten Entwürfe schnell mit älteren, aus einer früheren Ent- 
wicklungsphase, vergleichen. 

Zusätzlich zum Nutzen als Entwicklungswerkzeug 
benutzten wir Scrapbook+ in vielen Fällen, um kompli- 
zierte Wechselwirkungen der Zwischenablage mit sich 
selbst oder mit anderen Anwendungen zu testen. Darüber 
hinaus war es bei der Dokumentation des Programms ein 
Hilfsmittel unschätzbaren Werts. Mit ihm haben wir eine 
etwa 1,5 Mbyte große Datei erzeugt, die jede Illustration, 
jedes Bild, jede Bildschirmabbildung des Handbuchs und 
jedes Sinnbild enthielt. 


Im Rückblick 


Da nun die erste Version von Scrapbook + fertiggestellt ist, 
sind einige Betrachtungen über den ganzen Prozeß ange- 
bracht. Zuallererst sind wir uns der großen Herausforde- 
rung, die die Programmierung von Windows-Software in 
sich birgt, noch bewußter geworden. Obwohl teilweise auf- 
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grund der Komplexität der Umgebung, 
haben die Anforderungen an Software 
einen Punkt erreicht, den wir nur noch 
mit großen Mühen erreichen können. 

Wir sind weiterhin fest davon über- 
zeugt, daß die Programmierung in 
großen Modulen ein Überbleibsel 
vergangener Zeiten ist, und daß die 
Software der Zukunft aus kleinen voll- 
ständigen Paketen besteht, die von den 
Benutzern in eine funktionelle Umge- 
bung eingebunden werden. 

Wir haben auch gelernt, wie sehr 
wir geneigt waren, die Phase der Qua- 
litätssicherung bei der Entwicklung 
einer Windows-Anwendung zu unter- 
schätzen. Die Eigenschaften der 
gemeinsam genutzten Ressourcen und 
das Multiprocessing von Windows 
machen es schwer, Anwendungen zu 
testen, und einfache Fehler werden zu 
komplizierten Wechselwirkungen, 
deren Lösung Wochen dauern kann. 

Schließlich lernten wir, wie hinter- 
listig die Fallen von »eingeschlichenen 
Eigenschaften« sein können. Man sagt 
so leicht: »Laßt uns noch dies oder 
jenes mit einbauen, es dauert nur un- 
wesentlich länger.« Das Problem ist 
jedoch, das jedes dieser Features sei- 
nen Tribut fordert und sich das Aus- 
lieferungsdatum des Produkts immer 
weiter verschiebt. 

Wenn man alle Dinge betrachtet, 
dann hat sich Scrapbook+ zu einem 
Programm gemausert, das wir in der 
Art nicht erwartet hatten. Bei vielen 
Gelegenheiten haben wir uns gefragt: 
»Wie haben wir das bloß in den Griff 
bekommen?« Würden wir so etwas 
noch einmal machen? Ja, sofort, 
sobald wir wieder eine großartige Idee 
haben. 

Kevin P. Welch, David E. West 
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Das MS-Word-Dateiformat 


MS-Word Dateien lesen, erstellen und manipulieren 
Das Dateiformat von Microsoft Word 4.0 


Obwohl MS-Word ganz ohne Zweifel zu den 
populärsten PC-Programmen überhaupt zählt, 
bieten bisher nur ganz wenige Softwarehäuser 
sogenannte Add-On-Produkte für dieses erfolg- 
reiche Textverarbeitungsprogramm an, während 
der Markt gerade in den USA mit solchen Pro- 
dukten für andere Programme, wie etwa dBase 
oder Lotus 1-2-3, geradezu überschwemmt wird. 
Das Fehlen solcher Produkte für MS-Word liegt 
sicher nicht zuletzt an dem bisher undokumen- 
tierten Dateiformat, das aufgrund der Lei- 
stungsfähigkeit dieses Programms eine Komple- 
xität aufweist, die es einem Programmierer ohne 
weitere Hinweise fast unmöglich macht, sie zu 
entschlüsseln. 


Erstmalig veröffentlichen wir deshalb in dieser Folge des 
Microsoft System Journals das Dateiformat von MS-Word 
und geben Ihnen damit die Möglichkeit, MS-Word-Dateien 
mit eigenen Programmen zu verarbeiten oder Dateien für 
die Bearbeitung durch MS-Word zu erstellen. Dabei soll 
nicht nur die Theorie, also der Aufbau von MS-Word- 
Dateien im Vordergrund stehen. Vielmehr stellen wir ein 
nützliches Programm vor, mit dessen Hilfe Hardcopy- 
Dateien in Word-Dateien umgewandelt und Hardcopies 
dadurch direkt in den Text integriert werden können. 

Bei unseren Betrachtungen beziehen wir uns auf das 
Format der MS-Word-Version 4.0. Zwar weist die in den 
USA bereits angekündigte Version 5.0 demgegenüber 
einige, bisher undokumentierte Erweiterungen auf, doch 
spielen diese Veränderungen keine Rolle, solange Sie MS- 
Word-Dateien nur lesen oder erstellen. Eine Modifikation 
von Word-5.0-Dateien sollte jedoch unterbleiben, da in 
diesem Fall Probleme auftreten können, die in der Regel 
zum Absturz von MS-Word führen. 


Der Aufbau einer Word-Datei 


Eine Word-Datei unterteilt sich in drei Bereiche: 
a den Vorspann, 

= den eigentlichen Text und 

= die Format-Informationen 

(Zeichen-, Seiten-, Bereichs- und Absatz-Formate, Fuß- 

notenverweise und die Informationen über Textinhalt, 

Autor etc.) 

MS-Word unterteilt die Datei dabei in einzelne »Pages« 
(Seiten), die jeweils 128 Bytes umfassen. Jeder Bereich 
beginnt mit dem Anfang einer Page und nimmt mindestens 
eine Page in Anspruch, auch wenn er sie nicht ganz ausfüllt. 
Dadurch werden zwar unter Umständen einige Bytes ver- 
schenkt, doch ist es im Hinblick auf die Performance grund- 
sätzlich effizienter, mit festen Satzlängen zu arbeiten, als die 
einzelnen Bereiche unmittelbar aneinanderzuhängen. 
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Aufbau des Vorspanns in der Page 8 
(or. [rese __ Toeamtun 


wIdent Identitätscode, muß dezimal 
48689 enthalten 
ae 1 reserviert, muß ® enthalten | 1 nord | 
wTool Identitätscode, muß dezimal 
43776 enthalten 
reserviert, müssen 8 ent- 
halten 
Anzahl der Zeichen im Text 1 DWORD 
plus 128 
pnPara Page-Nummer mit der die 
Paragraphen-Fornate beginnen 
pnFntb Page-Nummer mit der die Fup- 
notentabelle beginnt 


Page-Nummer mit der die Be- 
reichsformate beginnen 


p Page-Numner mit der die 
Bereichs-Tabelle beginnt 


Page-Numner mit der die 
Seitenumbruchs-Tabelle be- 
ginnt 


Page-Nummer der Inhalts- 
angabe (Inhalt, Autor etc.) 


szSsht kompletter Dateiname der 
Druckformatvorlage als 


C-String 


is eu 


Name des Druckertreibers 8 BYTE 
ohne Erweiterung und Pfad 


als C-String 


Anzahl der Pages in der 

Datei 
Flag für die Markierung über- 
arbeiteter Textteile (s.u.) 


reserviert, müssen @ ent- 
halten 


28 BYTE 


Abbildung 1: Der Vorspann einer Word-Datei in der Page 0. 


Der Vorspann 


Die erste Page innerhalb einer MS-Word-Datei, also die 
Bytes mit den Offsetadressen 0 bis 127, nimmt den Vor- 
spann auf. Er enthält einige spezielle Codes, mit denen sich 
die Datei als eine MS-Word-Datei zu erkennen gibt, sowie 
Zeiger auf die Adressen bzw. Page-Nummern der einzelnen 
Bereiche innerhalb der Datei. Die Abbildung 1 zeigt den 
Aufbau des Datei-Vorspanns. 

Vielleicht kommen Ihnen die Namen der einzelnen Fel- 
der innerhalb des Vorspanns »spanisch« vor, da sie sich so 
ganz von der gewohnten Namensgebung für Variablen 
unterscheiden. Es sind jedoch die Original-Namen, die die 
Entwickler von MS-Word diesen Feldern gegeben haben, 
wobei sie sich weniger an das »Spanische«, als an das 
»Ungarische« gehalten haben. So nämlich werden die 


Das MS-Word-Dateiformat 


Aufbau des Bitfeldes »bfRev« im Vorspann einer Kord-Datei 


76543218 


| | L-> 1 = Korrekturleiste JA 
Darstellungsart des eingefügten Textes 
d= Unterstiichen En 
1 = Gropbuchstaben 
2 = Normal 
3 = Fett 
4 = nicht verwendet 
5 = nicht verwendet 


6 = doppelt unterstrichen 
7 = nicht verwendet 


Position der Korrekturleiste 

ß = keine Korrekturleiste 

1 = Korrekturleiste links 

2 = Korrekturleiste rechts 

1 = Korrekturleiste abwechselnd 


reserviert, müssen 8 sein 


(die Bits 8 bis 15 werden nicht benutzt und sollten 8 
enthalten) 


Abbildung 2: Aufbau des Feldes bfRev im Vorspann einer 
Word-Datei. 


Regeln zur Bildung von Variablennamen bezeichnet, die in- 
nerhalb der »Applications Development Group« von 
Microsoft eingesetzt werden. 

Ihren Namen verdanken diese Regeln zum einen der 
Nationaltität ihres Urhebers, Charles Simonyi, und zum 
anderen ihrer Undurchsichtigkeit für Außenstehende, die 
dadurch leicht auf den Gedanken kommen können, die 
Namen seien einer unbekannten Fremdsprache, wie etwa 
Ungarisch entliehen. Leider fehlt uns an dieser Stelle der 
Platz, um detaillierter auf die Regeln einzugehen, die der 
Bildung dieser Variablennamen zu Grunde liegen, doch 
wird sich eventuell ein Artikel in einer der nächsten Folgen 
des Microsoft System Journals mit diesem Thema beschäf- 
tigen. 

Kommen wir jedoch zurück zum Vorspann unserer MS- 
Word-Datei. Beachten Sie bitte, daß die Reihenfolge der 
verschiedenen Felder innerhalb des Vorspanns, die den 
Anfang eines der verschiedenen Bereiche innerhalb der 
Datei angeben (pnPara, pnFtb etc.), auch die Reihenfolge 
dieser Bereiche innerhalb der Datei widerspiegelt. Die Rei- 
henfolge lautet also: Vorspann, Text, Absatzformate, Fuß- 
notentabelle, Bereichsformate, Bereichstabelle, Seitenum- 
bruchs-Tabelle und schließlich Inhaltsangabe. 

Wie wir jedoch später noch sehen werden, muß eine 
MS-Word-Datei nicht unbedingt alle diese Komponenten 
enthalten, da es zum Beispiel keinen Sinn macht, eine Fuß- 
notentabelle anzulegen, wenn im Text gar keine Fußnoten 
definiert werden. 

Wie auch viele andere der im folgenden vorgestellten 
Strukturen, enthält der Vorspann ein Feld, dessen Inhalt 
nicht als Ganzes, sondern Bit für Bit interpretiert werden 


muß. Solche Variablen bezeichnet man als Bitfelder, wes- 
halb man in ihren Namen immer die Buchstabenkombina- 
tion bf findet. Das Flag bfRev (Offset 108) ist ein solches 
Bitfeld, das angibt, ob und wie überarbeitete Textteile ge- 
kennzeichnet werden sollen (Abbildung 2). 


Der Text 


Innerhalb der Word-Datei beginnt der eigentliche Text 
immer in der Page 1, also ab der Offsetadresse 128 inner- 
halb der Datei. Die Anzahl der gespeicherten Zeichen, wie 
auch die Anzahl der von ihnen belegten Pages ergibt sich 
aus dem Feld fcMac innerhalb des Vorspanns. Die Formel 
zur Berechnung der Anzahl der belegten Pages lautet: 


( fcMac - 1 ) / 128 


Innerhalb dieser Pages wird der Text fortlaufend gespei- 
chert, wobei je nach der Länge des Textes ein mehr oder 
minder großer Teil der letzten Page ungenutzt bleibt. Die 
einzelnen Zeichen werden im erweiterten IBM-ASCII-Zei- 
chensatz gespeichert, wobei der Text keinerlei Formatinfor- 
mationen enthält. Lediglich den folgenden Zeichen- bzw. 
Zeichenkombination ordnet MS-Word eine besondere 
Bedeutung zu: 


13,10 Absatzende. Die beiden Zeichen dürfen nur in Ver- 
bindung miteinander auftauchen und markieren grund- 
sätzlich das Ende eines Absatzes. 

11 Zeilenumbruch, der durch Betätigung von 
eingegeben wurde. 

12 Seitenumbruch, der durch Betätigung von 
eingegeben wurde und Seitenvorschub, den MS- 
Word bei der Formatierung erstellt hat. 

9 Tabulator 

32 ungeschütztes Leerzeichen 

255 geschützter Wortzwischenraum, 
(Etr1)[Space). 

45 wahlweiser Trennstrich 

196 geschützter Trennstrich, Eingabe durch [(Gtr1)(&ift)[-) 
(im IBM-ASCII-Zeichensatz entspricht dieses Zeichen 
ebenfalls dem ’--Zeichen. Die Interpretation dieses 
Zeichens durch MS-Word ist deshalb kontextsensitiv.) 

31 bedingte Trennstriche, Trennstriche, die von MS-Word 
innerhalb des Bibliotheksdienstes »Silbentrennung« 
angelegt oder mit [Ctr1)[-) eingegeben werden. 


Eine besondere Bedeutung kommt auch den folgenden 
Codes zu, wenn das Zeichen innerhalb der Zeichen-For- 
matbeschreiber als ein Zeichen mit dem Format fSpecial 
gekennzeichnet wird. Die einzelnen Codes entsprechen 
dann den verschiedenen Textbausteinen, die MS-Word 
grundsätzlich zur Verfügung stellt: 


1 (Seite) 

2 (Druckdatum) 
3 (Druckzeit) 

4 (Fußnote) 


Eingabe durch 
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Aufbau einer Page mit Zeichenformaten 


(ots.Trane ___ Teteutung 
fcFirst Nummer des ersten Zeichens, 1 DWORD 
dessen Format innerhalb die- 
ser Page beschrieben wird 
rgfod ein Array mit FODs (Format- 
Descriptors) 
it] | grpfprop eine Aneinaderreihung von 
Ma FPROPs (Format Properties) 
ER DE: Anzahl der FODs in dieser 
Page 
*das erste Zeichen innerhalb des Textes hat die Nummer 128 


Abbildung 3: Aufbau einer Page mit Zeichenformaten. 


Zeichenformate 


Der Bereich der Zeichenformate beginnt in der Page un- 
mittelbar hinter dem Text. Die zugehörige Page-Nummer 
läßt sich dadurch aus der Anzahl der Zeichen errechnen, 
die innerhalb des Vorspanns gespeichert sind. Die Formel 
dafür lautet: 


pnChar = ( fcMac + 127 ) / 128 


Die Zeichenformate beschreiben nicht das Format jedes 
einzelnen Zeichens, sondern das Format jeweils einer 
Gruppe von Zeichen, die über ein identisches Zeichenfor- 
mat verfügen. Identisch bedeutet in diesem Zusammen- 
hang, daß die Zeichenformate bis in das kleinste Detail 
übereinstimmen. Wenn ein Text aus Zeichen mit einem 
identischen Format besteht, aber ein Zeichen in der Mitte 
des Textes zusätzlich das Attribut »Fett« trägt, müssen 
bereits drei Formatbeschreiber, sogenannte Format Descrip- 
tors, angelegt werden. Einer für die Zeichen, bis zu dem 
Zeichen mit dem Attribut »Fett«. Einer für dieses Zeichen 
und schließlich einer für die Zeichen bis zum Ende des 
Textes. Wie die Abbildung 3 zeigt, kann eine Page dabei 
mehrere Formatbeschreiber aufnehmen. 

Wie hier ebenfalls zu sehen ist, befinden sich nur zwei 
Informationen innerhalb einer Page mit Zeichenformaten 
an einer fest lokalisierbaren Adresse: die Felder fcFirst 
und cfod. Ersteres gibt die Nummer des ersten Zeichens 
innerhalb des Textes an, das durch diese Page beschrieben 
wird. Daß die Zeichenpositionen innerhalb des Texts nicht 
ab 0, sondern ab 128 gezählt werden, hängt mit dem Aufbau 
der Datei zusammen. Wie wir eben gesehen haben, beginnt 
der eigentliche Text mit der zweiten Page innerhalb der 
Datei und damit ebenfalls mit der Offsetadresse 128. Durch 
das Fortschreiben der Zeichenpositionen ab 128 wird nun 
erreicht, daß die angegebene Zeichenposition jeweils auch 
der Offsetposition des Zeichens innerhalb der Datei ent- 
spricht. Dadurch läßt sich sowohl die Page, als auch die 
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Aufbau eines »Format Descriptors« (FOD) 


me Tee Im | 


Nummer des Zeichens hinter 
dem letzten Zeichen, das 


durch diesen FOD beschrie- 
ben wird 


bfprop Entfernung zwischen »rgfod« 
Bst Ri zugehörigen FPROP in 


s erste Zeichen innerhalb des Textes trägt die Nummer 128 


der Wert ÖFFFFh zeigt an, daß das Zeichenformat nicht vom 
Standardformat abweicht 


Abbildung 4: Aufbau eines Format Descriptors (FOD). 


Offsetadresse innerhalb dieser Page, an der sich das bzw. 
die beschriebenen Zeichen befinden, leicht errechnen. Die 
zugehörigen Formeln lauten: 


Position / 128 
Position modulo 128 


PageNummer = 
Page0ffset = 


Da die einzelnen Formatbeschreiber eine variable Länge 
besitzen, paßt nicht immer die gleiche Anzahl von ihnen in 
eine Page. Deshalb wird ihre Anzahl jeweils innerhalb der 
Variablen cfod angegeben. Damit wird auch die Anzahl 
der Formatbeschreiber (FODs) im Array rgfod festgelegt. 
Die einzelnen FODs haben dabei folgenden Aufbau. 

Die Abbildung 4 macht deutlich, daß der Format 
Descriptor seinem Namen keine Ehre macht, da er das 
Format der Zeichen nicht selbst beschreibt, sondern ledig- 
lich einen Verweis auf einen sogenannten FPROP, auf einen 
Formatting Property enthält, der das Format der Zeichen 
festlegt. Dies macht durchaus Sinn, denn dadurch kann 
innerhalb der Page eine Menge Speicherplatz gespart 
werden, wenn die Zeichen verschiedener Bereiche ein iden- 
tisches Format aufweisen. 

Dies ist zum Beispiel in dem oben angeführten Beispiel 
der Fall, da sowohl die Zeichen vor dem Zeichen mit dem 
Attribut »Fett«, als auch die Zeichen dahinter über ein 
identisches Format verfügen. Sofern die zugehörigen For- 
mat Properties in eine Page passen (und davon kann man 
ausgehen), müssen innerhalb dieser Page lediglich zwei von 
ihnen angelegt werden. Einer für die Zeichen vor und hinter 
dem »fetten« Zeichen und einer für dieses Zeichen selbst. 

Innerhalb von rgfod verweisen dann der erste und der 
dritte Eintrag auf ein und denselben Format Property. 
Beachten Sie aber bitte, daß dies nur in solchen Fällen 
möglich ist, in denen sich mehrere Zeichenbereiche mit 
identischem Format innerhalb einer Page befinden, da das 
Feld bfprop innerhalb eines FODs nicht aus einer Page 
hinausweisen darf. 

Eine einwandfreie Zuordnung der verschiedenen 
FPROPs zu den einzelnen Zeichenbereichen gewährleistet 
das Feld fcLim innerhalb des FOD. Es gibt die Nummer 
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Aufbau eines »Formatting Properties« (FPROP) innerhalb der 
Zeichenformate 


(ors.[rane __ Taeintung 
Anzahl der Bytes in diesem 
FPROP exklusive dieses Bytes 
chpbf1 Code des Zeichenformats aus 
der Druckformatvorlage 


chpbf2 Zeichenforgat und Zeichen- 
satznummer 


Größe des gewählten Zeichen- 
satzes in halben Punkten 


chpbf3 weitere Zeichenattribute* 1 Brre | 
hpsPitch reserviert, muß 8 enthalten Ki 
horizontale Zeichenposition** 1 are | 


T reserviert, müssen 8 ent- 
-18 halten 


*hier handelt es sich um Bitfelder, die auf den folgenden 
„seiten beschrieben werden 
8 steht für normal, 1-127 für hochgestellt, 
128-255 für tiefgestellt 


Abbildung 5: Aufbau eines Formatting Properties (FPROP) 
innerhalb der Zeichenformate. 


des Zeichens hinter dem letzten Zeichen an, auf das sich 
der jeweilige FOD bezieht. Für den ersten FOD sind dies die 
Zeichen zwischen fcFirst (Abbildung 3) und fcLim-1 im 
ersten FOD. Der zweite FOD beschreibt dann die Zeichen 
zwischen fcLim aus dem ersten FOD und seinem eigenen 
fcLim-1,. Allgemein läßt sich daher festhalten: 


StartZeichen, = fcFirst für n=-® und 
feLim(n-ı) für n<>0 


EndZeichen, = feLim,_1 


Da die einzelnen FODs die verschiedenen Zeichenberei- 
che grundsätzlich in aufsteigender Reihenfolge beschreiben, 
die erste dieser Pages mit dem ersten Zeichen innerhalb des 
Textes beginnt und alle darauffolgenden Pages jeweils an 
das Ende der vorangegangenen Page anknüpfen, markiert 
das Feld fcLim im letzten FOD einer Page gleichzeitig das 
erste Zeichen in der nächsten Page und damit den Inhalt 
des Feldes fcFirst in der darauffolgenden Page. 

Beachten Sie bei der Erstellung oder Manipulation von 
MS-Word-Dateien bitte, daß jedes Zeichen innerhalb des 
Textes durch einen FOD beschrieben werden muß und das 
Feld fcLim im letzten FOD innerhalb der letzten Page der 
Zeichenformate auf das Zeichen hinter dem letzten Zei- 
chen im Text zeigen muß. Bereits ein kleiner Fehler kann 
dabei den Absturz von MS-Word zur Folge haben, wenn es 
die Zeichenformate nicht in der erwarteten Anordnung 
vorfindet. 


Aufbau des Bitfeldes »chpbf1« innerhalb des Character 
Properties (CHP) 


76543218 


Bl 


L-> 1 = die Zeichen wurden mit einem Zei- 
chennuster aus der Druckformat- 
vorlage formatiert 


Nummer der Variante 
(8 = Standard-Zeichenfornmat) 


Abbildung 6: Aufbau des Bitfeldes chpbf1 innerhalb des 
Character Properties (CHP). 


Kommen wir zurück zu den Zeichenformaten und damit 
zu den FPROPs, die diese Formate beschreiben. Während 
das Array rgfod mit jedem Eintrag auf das Ende der Page 
zuwächst, wachsen die FRPROPs vom Ende der Page in 
Richtung auf das Ende von rgfod. Das Ende des ersten 
FPROPs, also des Formatbeschreibers, der durch 
rgfod[®] beschrieben wird, grenzt dadurch unmittelbar 
an das Feld cfod am Ende der Page. Der zweite FPROP 
(rgfod[1]) endet unmittelbar vor dem ersten FPROP. In 
dieser Weise »folgen« die weiteren FPROPs, bis nicht mehr 
genug Platz zwischen dem Ende des Arrays rgfod und 
dem letzten FPROP ist, um einen weiteren FPROP in die 
Page aufzunehmen. Den Aufbau eines solchen FPROPs 
zeigt die Abbildung 5. 

Eine besondere Bedeutung innerhalb eines FPROPs 
kommt dem Feld cch zu. Um Platz zu sparen und dadurch 
möglichst viele Zeichenbereiche innerhalb einer Page 
beschreiben zu können, werden nämlich nur so viele Bytes 
des FRPOPs gespeichert, wie »unbedingt notwendig« sind. 
Mit diesem Terminus werden dabei alle Bytes zwischen 
dem Feld chpbf1 und dem letzten Feld bezeichnet, das 
nicht den Defaultwert enthält. Als Defaultwert wird dabei 
für das Feld chpbf1 der Wert 1 (Standard-Zeichenformat), 
für das Feld hps der Wert 24 (Zeichengröße ist 12 Punkt) 
und für alle anderen Felder der Wert 0 festgelegt. 

Wenn nun zum Beispiel das Feld chpbf3 als letztes 
Feld innerhalb des FPROP nicht den Defaultwert enthält, 
müssen nur die Felder chpbf1 bis chpbf3 erfaßt werden. 
Das Feld cch enthält in diesem Fall den Wert 4. 

Die Felder chpbf1 bis fpres innerhalb der Abbildung 
5 bezeichnet man übrigens auch als Character Pro- 
perty, abgekürzt CHP. Innerhalb des CHPs spielen ver- 
schiedene Bitfelder eine große Rolle. Den Aufbau dieser 
Bitfelder zeigen die Abbildungen 6 bis 9. 

Wie die Abbildung 6 zeigt, gibt das Bit 0 innerhalb des 
Bitfeldes chpbf1 an, ob das/die beschriebenen Zeichen 
mit einem Zeichenmuster aus der Druckformatvorlage for- 
matiert wurden. Trifft dies zu, wird der Inhalt der Bits 1 bis 
7 als die Varianten-Nummer dieses Zeichenmusters inter- 
pretiert (ste: Style Code), wobei 0 für das Standard-Zei- 
chenformat in dem jeweiligen Absatz steht (Abbildung 7). 
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Die möglichen Werte eines Style Codes (stc) 


EN Standardzeichen) 
Fußnotenverweis 

13-17 

Seitenzahl 

18-25 (SA-S7 in SCREEN.DFV) 
Kurzinformationen 
Zeilennummern 


Zeichen 


Fupnotentext 

9-56 (56 = SC in SCREEN.DFV) 
Überschriften Ebene 1-7 
Index Ebenen 1-4 

Tabellen Ebenen 1-4 
Kopf-/Fupzeile 


185 Bereich Standard 
186-126 | Bereich 1-21 


Abbildung 7: Der Style Code (stc) in den Properties. 


Aufbau des Bitfeldes »chpbf2« innerhalb des Character 
Properties (CHP) 


76543218 
| L-> 1 = Zeichen werden fett dargestellt 
1 = Zeichen werden kursiv dargestellt 


Font-Nummer 
(Index in die Font-Tabelle) 


Abbildung 8: Aufbau des Bitfeldes chpbf2 innerhalb des 
Character Properties (CHP). 


Aufbau des Bitfeldes »chpbf3« innerhalb des Character 
Properties (CHP) 


76543218 
| L_> 1 = die Zeichen werden unterstrichen 
1 = die Zeichen werden durchgestrichen 


= die Zeichen werden doppelt unter- 
strichen 


die Zeichen wurden eingefügt, 
während die Karraklurieiste an- 
geschaltet war 


Zeichengröße 

8 = normal 

1 = Gropbuchstaben 
2 = Kapitälchen 


1 = besonderes Zeichen 
(Seite), (Druckdatum), (Druckzeit) etc. 


1 = Zeichen ist versteckt 


Abbildung 9: Aufbau des Bitfeldes chpbf3 innerhalb des 
Character Properties (CHP). 
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Aufbau des Formatting Property (FPROP) innerhalb einer Page 
mit Absatzformaten 


Anzahl der Bytes in diesen 1 BYTE 
FPROP exklusive dieses Bytes 
papbf1 Code des Absatzformats aus 
der Druckformatvorlage 
Absatzattribute* 
stcNorm Varianten-Nummer des Stan- 
dardzeichenformats 
papbf3 Absatzattribute* 
dxaRight rechter Absatzeinzug in 
Tuips®* 
dxaLeft linker Absatzeinzug in 1 WORD 
Twips 
dxaLeft1 linker Absatzeinzug der 1 WORD 
ersten Zeile in Twips 
Zeilenabstand in Tuips 
dyaBefore Anfangsabstand in Twips 


BEE 
m | 
(ararer | mind in mie Tram] 
pt Tai rem] 

en 


(irre Türen” | 
papres reserviert, müssen 9 ent- 
halten 


rgTBD Array mit Tabulatorbeschrei- | 28 TBD 
bern (TBDs) 


*hier handelt es sich um Bitfelder, die auf den folgenden 
Fr eiten beschrieben werden 
ein Twi Yu einem 1/28stel Punkt und damit einem 
1/144ßstel Zoll 


Ku 
ic 
c 
FB 


Abbildung 10: Aufbau des Formatting Properties in einer 
Page mit Absatzformaten. 


Weichen einzelne Attribute des Zeichenformats von 
dem Zeichenmuster ab, oder wurde das Zeichen nicht über 
ein Zeichenmuster aus der Druckformatvorlage formatiert, 
geben die weiteren Bitfelder Aufschluß über das Format 
der Zeichen. 


Absatzformate 


Die Art und Weise, in der MS-Word die Formate der ver- 
schiedenen Textabsätze speichert, unterscheidet sich nur 
wenig von der Speicherung der Zeichenformate. Auch hier 
nimmt jeweils eine Page die Formate eines oder mehrerer 
Absätze auf, wobei der Aufbau der Page mit der bei Zei- 
chenformaten identisch ist. Auch hier gilt, daß die Absätze 
beginnend mit dem ersten Zeichen des Textes in der ersten 
Absatzformat-Page, fortlaufend beschrieben werden, bis der 
Absatz erreicht ist, in dem sich das letzte Zeichen des Tex- 
tes befindet. 
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Aufbau des Bitfeldes »papbf1« innerhalb des Pragraph 
Properties (PAP) 


765432198 


SB 


L-> 1 = der Absatz wurde mit einem Absatz- 
nmuster aus der Druckformatvorlage 
forsatiert 


Nummer der Variante 


Abbildung 11: Aufbau des Bitfeldes papbf1 innerhalb des 
Paragraph Properties (PAP). 


Aufbau des Bitfeldes »papbf2« innerhalb des Par h 
Properties (CHP) er ki 
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HANIH 


[1 Ausrichtung des Absatzes 
8 = linksbündig 
1 = zentriert 
2 = rechtsbündig 
3 = Blocksatz 
1 = selbe Seite 
1 = nächster Absatz auf selber Seite 
1 = Nebeneinander 


reserviert, muß 8 enthalten 


Abbildung 12: Aufbau des Bitfeldes papbf2 innerhalb des 
Paragraph Properties (PAP). 


Aufbau des Bitfeldes »papbf3« innerhalb eines Paragraph 
Properties 


76543218 


| LI 1) Nummer der Gliederungsebene 
1 = Gliederungsebene ist ausgeblendet 


Abbildung 13: Aufbau des Bitfeldes papbf3 innerhalb eines 
Paragraph Properties (PAP). 


Anstelle des Zeichenformats einer Gruppe von Zeichen 
beschreibt der Formatting Property hier das Format des 
Absatzes, in dem sich die jeweiligen Zeichen befinden. Der 
einzige Unterschied zu den Zeichenformaten besteht des- 
halb auch in dem Aufbau dieser Datenstruktur, die in der 
Abbildung 10 beschrieben wird. 

Die Nummer der ersten Page mit Absatzformaten gibt 
das Feld PnFntb im Vorspann der Datei an. 

Um einen FPROP mit Absatzformaten auch sprachlich 
von einem solchen mit Zeichenformaten abgrenzen zu kön- 
nen, werden die Felder papbf1 bis rgTBD als Paragraph 


Aufbau des Bitfeldes »papbf4« innerhalb des Paragraph 
Properties (PAP) 
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L> 8*= Absatz ist Kopfzeile 
1 = Absatz ist Fußzeile 


1 = Kopf-/Fupzeile auf ungeraden Seite 


1 = Kopf-/Fupzeile auf geraden Seiten 


1 = Kopf-/Fußzeile auf der ersten Sei. 


Rahmentyp 
ß = kein Rahmen um den Absatz 
1 = kompletten Rahmen um den Absatz 
2 = Rahmenseiten werden durch das 
Feld »tyframe« bestimmt 
3 = wird nicht verwendet 


Art des Rahmens 

8 = einfachen Rahmen 

1 = doppelten Rahmen 

2 = einfacher Rahmen, fett 
3 = wird nicht verwendet 


*Bei dem Absatz handelt es sich nur dann um eine Kopf- oder 
Fupzeile, wenn mindestens eines der Bits 1 bis 3 den kert 
1 enthält 


Abbildung 14: Aufbau des Bitfeldes papbf4 innerhalb des 
Paragraph Properties (PAP) 


Property, kurz PAP, bezeichnet. Auch für den PAP gilt, 
daß MS-Word versucht, möglichst wenige Felder abzuspei- 
chern, um Speicherplatz zu sparen. Die Anzahl der ge- 
speicherten Bytes wird wiederum innerhalb des Feldes cch 
erfaßt. Abhängig ist dies auch hier davon, inwieweit der 
Inhalt der Felder dem von MS-Word festgelegten Default- 
werten entspricht. 

Der Defaultwert für das Feld papbf1 ist 61 (Standard- 
absatz), für das Feld stcNorm 30 (Font), für das Feld 
dyaLine 240 (12 Punkte) und für alle anderen Felder 0. 

Ob der jeweilige Absatz über ein Absatzmuster inner- 
halb der Druckformatvorlage oder auschließlich »von 
Hand« formatiert wurde, zeigt das Bitfeld papbfi an 
(Abbildung 11). Die Absatzvarianten wurden bereits in 
Abbildung 7 beschrieben. 

Wird innerhalb des Textes mit Gliederungsebenen gear- 
beitet, spielt das Bitfeld papbf3 innerhalb des Paragraph 
Properties eine wichtige Rolle (Abbildung 13). 

Ob es sich bei dem Absatz um eine Kopf- oder Fußzeile 
handelt, und ob der Absatz mit einem Rahmen versehen 
werden soll, darüber gibt das Feld papbf4 Auskunft 
(Abbildung 14). 

Enthalten die Bits 4 und 5 innerhalb des Feldes papbf4 
den Wert 2, dann bestimmt das Feld tyframe die Art des 
Rahmens, d.h. die Seiten, an denen der Rahmen geschlos- 
sen ist (Abbildung 15). 

Ob der Absatz über die Tabulatoren in dem jeweiligen 
Absatzmuster hinaus mit weiteren Tabulatoren versehen 
wurde, erkennen Sie am Inhalt des Feldes cch. 
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L> 1 = Linie auf der linken Seite 
1, 1 = Linie auf der rechten Seite 
1 = Linie am oberen Rand 
1 = Linie am unteren Rand 


werden nicht benutzt 


Abbildung 15: Aufbau des Bitfeldes tyframe innerhalb des 
Paragraph Properties (PAP) 


Aufbau eines »Tab Descriptors« (TBD) innerhalb eines PAP 


(or [ren Tartanıng Im 


Abstand des a vom 
linken Rand in Tw 
| 2 [ter | Tabulator-Attribute 


Zeichen, nach dem der Tabu- 
lator ausgerichtet werden 
soll, wenn es sich um einen 
Dezimaltabulator handelt 


*pefindet sich in diesem Feld der ASCII-Code 8, wird das 


Zeichen als ”."” interpretiert 


Abbildung 16: Aufbau eines Tab Descriptors (TBD) inner- 
halb eines Paragraph Properties. 


Nur wenn Tabulatoren angelegt wurden, enthält es 
einen Wert größer 22 und zeigt damit an, daß das Array 
rgTBD Informationen enthält. Da jeder Tab Descriptor 
(TBD) innerhalb des Arrays 4 Bytes beansprucht, läßt sich 
aus dem Inhalt von cch auch gleich die Anzahl der Tabula- 
toren errechnen: 


AnzTab = ( cch - 22) / 4 


Der Tab Descriptor hat die in Abbildung 16 gezeigte 
Struktur. Die Abbildung 17 zeigt, wie die Attribute des 
Tabulators innerhalb des Bitfeldes tbdbf1 kodiert werden. 


Fußnoten 


Enthält ein Text Fußnoten, muß MS-Word natürlich auch 
Informationen über die Fußnotenverweise und die zugehö- 
rigen Fußnotentexte speichern. Sowohl die Verweise, als 
auch die Texte selbst sind dabei ganz normaler Bestandteil 
des Textes und werden wie alle anderen Zeichen innerhalb 
des Textteils der Datei gespeichert. Um sich jedoch die 
Position der Verweise und der zugehörigen Texte merken 
zu können, legt MS-Word eine sogenannte Footnote Table 
an, die in ihrer Kurzbezeichnung als FNTB bezeichnet wird. 
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MER 


L—1-> Ausrichtung des Tabulators 
8 = links 


1 = zentriert 

2 = rechts 

3 = dezimal 

4 = senkrechter Strich durch Absatz 


Füllzeichen 

8 = Leerzeichen 

1 = Punkte 

2 = Bindestriche 

3 = Leerzeichen unterstrichen 


ungenutzt, müssen 8 enthalten 


Abbildung 17: Aufbau des Feldes tbdbf1 innerhalb eines 
Tab Descriptors. 


Aufbau der »Footnote Table« (FNTB) 


(or Tr: Toeteung Te] 


rgfnd Array mit den einzelnen Fup- 
notenbeschreibern (FNDs) 


Abbildung 18: Aufbau der Footnote Table (FNTB). 


Ob sich eine derartige Tabelle innerhalb einer MS- 
Word-Datei befindet, läßt sich anhand des Feldes pnFntb 
im Vorspann der Datei feststellen. Enthält dieses Feld den 
gleichen Wert wie das darauffolgende Feld pnSep, enthält 
die Datei keine Fußnotentabelle und der Text damit auch 
keine Fußnoten. Unterscheiden sich die beiden Werte 
jedoch, gibt pnFntb die Nummer der Page an, mit der die 
Fußnotentabelle beginnt. Die Abbildung 18 zeigt den Auf- 
bau dieser Tabelle. Die Größe der Footnote Table und 
damit die Anzahl der Pages, die durch sie belegt werden, 
ergibt sich aus der Anzahl der Fußnoten und aus der Größe 
eines Footnote Descriptors (FND) nach folgender Formel: 
fnPages = (4 +8* ( cfnd - 1 ) ) / 128 

Wird mehr als eine Page für die Footnote Table benö- 
tigt, setzt sich das Array rgfnd nahtlos in den folgenden 
Pages fort, wobei die letzte Page bis zu ihrem Ende mit 
Nullen aufgefüllt wird. Die einzelnen Fußnotenbeschreiber 
(Footnote Descriptors, FNDs) sind dabei so aufgebaut, wie 
das in Abbildung 19 zu sehen ist. 

Beachten Sie, daß die einzelnen FNDs innerhalb der 
Footnote Table sortiert nach dem Feld cpRef in aufstei- 
gender Reihenfolge aufgeführt werden und daß die Offset- 
positionen in den Feldern cpRef und cpFtn im Gegensatz 
zu den Positionsangaben in den Zeichen- und Paragra- 
phenformaten nicht ab 128, sondern ab 0 gezählt werden. 
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Aufbau eines »Footnote Descriptors« (FND) 


(ons __ Toetenung Im 


Offsetposition des Fußnoten- | 1 DWORD 
verweises im Text 


Offsetposition des Fupnoten- | 1 DWORD 
textes im Text 


Abbildung 19: Aufbau eines Footnote Descriptors (FND). 


Aufbau der »Section Table« (SETB) 


Anzahl der Bereiche 
(mindestens 1) 
| 2 | osedtan | entspricht dem Feld »csed« | 1 word | 
rgsed Array mit Segmentbeschrei- 
bern 


Abbildung 20: Aufbau der Section Table (SETB). 


Bereichsformate 


Untergliedert sich ein Text in verschiedene Bereiche oder 
wird der einzige Bereich innerhalb eines Textes »von 
Hand« formatiert und weist dadurch nicht mehr das Stan- 
dard-Bereichsformat auf, legt MS-Word für jeden Bereich 
einen Bereichsbeschreiber (Section Descriptor, SED) 
an, den es in die Section Table (SETB) eingliedert. Ob 
eine solche Tabelle existiert und in welcher Page sie 
beginnt, erkennen Sie am Inhalt des Feldes pnSetb inner- 
halb des Vorspanns. Ist sein Inhalt mit dem des darauffol- 
genden Feldes pnPgtb identisch, dann enthält die Datei 
keine Bereichsbeschreiber. Anderenfalls gibt der Inhalt von 
pnSetb die Nummer der Page an, mit der die Section Table 
beginnt. 

Aus der Anzahl der Bereiche (Feld csed) ergibt sich 
auch die Anzahl der Pages, über die sich das Array rgsed 
erstreckt, sofern es zu groß ist, um in einer Page Platz zu 
finden. Die folgende Formel gibt die Anzahl der belegten 
Pages an und berücksichtigt dabei die Größe der Segment- 
beschreiber. 


sePages = ( 4 + ( csed * 18 ) ) / 128 


Da die Section Table in den seltensten Fällen genau mit 
dem Ende einer Page abschließt, wird der ungenutzte Teil 
der letzten Page mit Nullen gefüllt. Die einzelnen Seg- 
mentbeschreiber innerhalb des Arrays rgsed haben die in 
Abbildung 21 beschriebene Struktur. 

Über das Feld cp innerhalb des SEDs werden die ein- 
zelnen Bereiche innerhalb des Textes voneinander abge- 
grenzt. Der erste SED beschreibt dabei den Bereich vom 
ersten Zeichen des Textes bis zu dem Zeichen, auf das sein 
ep-Feld zeigt. 


Aufbau eines »Segment Descriptors« (SEDs) innerhalb der 
»Section Table« (serB) 


(ers These  Treaanng Im 


Offsetadresse des Absatz- 1 DWORD 
Ende-Zeichens innerhalb des 

Textes 

wird nicht genutzt | 1 woRD | 


Offsetadresse des zugehöri- 1 DWORD 
en »Segment Properties« 
nnerhalb der Datei 


Abbildung 21: Aufbau eines Segment Descriptors (SED). 


Aufbau eines »Section Properties« (SEP) 


(or [ne Toctenung Im] 


cch Anzahl der Bytes innerhalb 
des SEPs exklusive dieses 
Bytes 
5 sepbf1 Bereichsmuster”* 


2] sepbf2 Bereichs-Attribute* | 1 arme | 
Seitenlänge in Twips 


Seitenbreite in Twips 


erste Seitennumner 
oberer Rand in Twips 


Länge des Textbereichs in 
Twips 
linker Rand in Twips 


Breite des Textbereichs in 
Twips 

weitere Absatzattribute* 
Anzahl der Spalten 


Abstand der Kopfzeile vom 
Blattanfang in Twips 

Abstand der Fußzeile vom 
Blattende in Twips 

Abstand zwischen den Spalten 
in Twips 

Breite des Bundstegs in Twips 
Abstand der Seitennummer vom 
oberen Blattrand in Twips 
Abstand der Seitennummer vom 
linken Blattrand in Twips 


Abstand der Zeilennummern 
vom linken Blattrand in Twips 


ibt an, jede wievielte Zei- 
e mit einer Zeilennummer 
versehen werden soll 


xaMAc 


| 8158 
| &1°|8 


5 


Text 


_ 
=) 


kl 
EEEEGEIR 


dxaGutter 


nu 
J 


ENIEN 


yaPgn 
xaPgn 
dxaLnn 


*es handelt sich bei diesem Feld um ein Bitfeld, das auf 
den folgenden Seiten beschrieben wird 


Abbildung 22: Aufbau eines Section Properties (SEP). 
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Defaultwerte für die einzelnen Felder eines »Section 
Properties« (SEP) 


Abbildung 23: Defaultwerte für die einzelnen Felder eines 
Section Properties (SEP). 


Der nachfolgende SED beschreibt dann den Bereich 
zwischen dem cp-Feld seines Vorgängers plus 1 und seinem 
eigenen cp-Feld. In dieser Weise beschreiben die einzelnen 
SEDs die verschiedenen Bereiche innerhalb des Textes in 
aufsteigender Reihenfolge, so daß das cp-Feld des letzten 
SEDs hinter das letzte Zeichen im Text zeigt. Beachten Sie 
dabei aber bitte, daß die Zeichenpositionen innerhalb der 
Datei im Gegensatz zu den Zeichen- und Absatzbeschrei- 
bern nicht ab 128, sondern ab 0 gezählt werden. 

Wie die Abbildung 21 zeigt, beschreibt der SED das 
Format und die Attribute »seines« Bereichs jedoch nicht 
selbst, sondern überläßt diese Aufgabe einem Section Pro- 
perty (SEP), dessen Offsetadresse innerhalb der Datei er 
angibt. Ähnlich wie bei den Zeichen- und Absatzbeschrei- 
bern ergibt sich dadurch die Möglichkeit, mehrere Bereiche 
durch einen SEP beschreiben zu lassen und dadurch Spei- 
cherplatz zu sparen. Den Aufbau eines solchen SEPs ver- 
deutlicht die Abbildung 22. 

Auch bei der Erstellung der SEPs nutzt MS-Word die 
Möglichkeit, Speicherplatz zu sparen, indem nur der Teil 
des SEPs gespeichert wird, dessen Inhalt nicht den Default- 
werten entspricht. Wie bei den Character- und Paragraph- 
Properties gibt auch im SEP ein Feld mit dem Namen cch 
die Anzahl der gespeicherten Bytes innerhalb der Struktur 
an. Welche Werte MS-Word bei den einzelnen Feldern als 
Defaultwerte voraussetzt, zeigt die Abbildung 23. 

Zwei wichtige Informationen, die Position des rechten 
und des unteren Endes des bedruckbaren Blattbereichs, 
gehen aus dem SEP nicht direkt hervor, können aber durch 
eine Verknüpfung der anderen Felder errechnet werden. 
Die entsprechenden Formeln lauten: 


xaRight = xaMac - xaLeft - dxaText 
yaBottom = yaMac - yaTop - dyaText 
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Aufbau des Bitfeldes »sepbf1l« innerhalb des Section 
Properties (SEP) 


76543218 


Ba 


L-> 1 = der Bereich wurde über ein Be- 
reichsmuster aus der Druckformat- 
vorlage formatiert 


Nummer der Variante 


Abbildung 24: Aufbau des Bitfeldes sepbf 1 innerhalb eines 
Section Properties (SEP). 


Aufbau des Bitfeldes »sepbf2« innerhalb eines Section 
Properties 


76543218 


A 


L1 > Bereichswechsel 
8 = fortlaufend 
1 = Spalte 
2 = Seite 
3 = gerade 
4 = ungerade 


Format der Seitennummern 

8 = arabische Ziffern 

1 = lateinische Schreibweise, groß 
2 = lateinische Schreibweise, klein 
3 = Buchstaben, groß 

4 = Buchstaben, klein 


ungenutzt, müssen 8 enthalten 


Abbildung 25: Aufbau des Bitfeldes sepbf2 innerhalb eines 
Section Properties (SEP). 


Aufbau des Bitfeldes »sepbf3« innerhalb eines Section 
Properties (SEP) 


76543219 


[IIIITIT 
L-> 1 = 2222222277777772 
a 1 = 27777722222277? 
1 = 227777272222777? 
1 = 77272722722777? 


reserviert, mup 8 enthalten 


1 = Zeilennummerierung an 


1 = Seitenzahlen ohne Kopfzeilen aus- 
geben 


1 = Fußnoten am Ende des Textes aus- 
drucken 


Abbildung 26: Aufbau des Bitfeldes sepbf 3 innerhalb eines 
Section Properties (SEP). 
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Aufbau der »Page Table« (PGTB) 


(ors[rese Tree _ Im | 
af ren Fon dr Dutserten [1 mn | 
BEI Eu I EL E 
rgpgd Array mit den einzelnen Sei- 
BE 


Abbildung 27: Aufbau der Page Table (PGTB). 


Aufbau eines »Page Descriptors« (PGD) 


rss Treten Im | 
(Ramer der De [rem] 


cpMin Offsetposition des ersten 
Zeichens dieser Druckseite 
innerhalb des Textes 


Abbildung 28: Aufbau eines Page Descriptors (PGD). 


Wie die Abbildung 22 zeigt, enthält ein Section Property 
verschiedene Felder, deren einzelne Bits Informationen 
über die Attribute des Bereichs liefern. Das erste dieser 
Felder trägt den Namen sepbf1 und zeigt an, ob der 
Bereich über ein Bereichsmuster aus der Druckformatvor- 
lage formatiert wurden (Abbildung 24). Die Varianten der 
Bereichsmuster wurden bereits in Abbildung 7 beschrieben. 

Über den Bereichswechsel und das Format der Seiten- 
nummern gibt das Feld sepbf2 Auskunft (Abbildung 25). 


Position der Seitenumbrüche 


Nach dem ersten Druck eines Textes kennt MS-Word die 
Lage der Seitenumbrüche innerhalb des Textes und spei- 
chert diese Information innerhalb der Textdatei hinter der 
letzten SEP-Page ab. 

Ob der Text bereits mindestens einmal gedruckt wurde 
und diese Informationen damit zur Verfügung stehen, er- 
kennt man am Inhalt des Feldes pnPgtb im Vorspann der 
Datei. Ist sein Inhalt mit dem des darauffolgenden Feldes 
(pnSumd) identisch, liegen diese Informationen noch nicht 
vor. Anderenfalls gibt der Inhalt von pnPgtb die Nummer 
der Page innerhalb der Datei an, mit der die Informationen 
über die Lage der Seitenumbrüche beginnen. Diese Page 
enthält die sogenannte Page Table, deren Aufbau die Abbil- 
dung 27 zeigt. 

Die Größe der Page Table und damit die Anzahl der 
(Disk-) Pages, die durch sie belegt werden, ergibt sich aus 
der Anzahl der Druckseiten und aus der Größe eines Page 


Descriptors (PGD) nach folgender Formel: 
pgPages = (4+6* ( cped - 1 ) ) / 128 


Wird mehr als eine Page für die Page Table benötigt, 
setzt sich das Array rgpgd nahtlos in den folgenden Pages 


Aufbau der Page mit Informationen über den Text 


Por Treten mp 
ne fra Tram 
BEI Cu LE EL 
BD ES EI EL 
eerert [rem Tram] 
omas remmar rum] 
(otrsin | Versimenaner dr Toner" [Vu 
EEE 


Datum der letzten Überar- 
beitung 


dCreation Datum der Erstellung** 
| nmars | Anzahl der Zeichen im Text | 1 DWORD 


*diese Felder enthalten die Se in der jeweiligen 
Information innerhalb der Page. Die Information selbst ist 
dort im Format eines C-Strings verzeichnet. 


**diese Felder enthalten die Offsetposition des Datums 
innerhalb der >: Das Datum ist jeweils als ein Feld 
bestehend aus 8 Zeichen aufgebaut. 


Abbildung 29: Aufbau der Page mit Informationen über den 
Text. 


fort, wobei die letzte Page bis zu ihrem Ende mit Nullen 
aufgefüllt wird. Die einzelnen Seitenbescheiber (Page 
Descriptors, PGDs) sind dabei so aufgebaut, wie es in 
Abbildung 28 zu sehen ist. 


Informationen über den Text 


MS-Word bietet ab der Version 4.0 die Möglichkeit, neben 
dem eigentlichen Text auch Informationen über den Text, 
wie etwa den Titel, den Namen des Autors und einen 
Kommentar zu erfassen. Diese Informationen speichert es 
in einer gesonderten Page innerhalb der Textdatei ab, deren 
Page-Nummer es innerhalb des Vorspanns in dem Feld 
pnSumd verzeichnet. Den Aufbau dieser Page zeigt die Ab- 
bildung 29. 


Das Programm BW.C 


Ein schönes Beispiel für die Erstellung von MS-Word- 
Dateien ist das Programm BW.C, dessen Listing Sie auf den 
folgenden Seiten finden. Es schließt an das TSR-Programm 
BILD an, das wir in der November /Dezember-Ausgabe des 
letzten Jahres veröffentlicht haben. 

Nachdem Sie mit Hilfe von BILD die Hardcopy eines 
80*25-Zeichen-Textbildschirms in eine Datei geschrieben 
haben, können Sie sie mit Hilfe von BW (das steht für 
»BildWord«) in eine MS-Word-Datei umwandeln lassen, 
die Sie wie jede andere Text-Datei in Ihre Texte einbinden 
können. Dadurch wird es möglich, Hardcopies als integra- 
len Bestandteil eines Textes zu behandeln und dadurch den 
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Aufwand des »Einmontierens« zu ersparen. Außerdem hilft 
Ihnen die direkte Einbindung der Hardcopies natürlich 
auch bei der Formatierung des Textes, da MS-Word die 
Größe der Hardcopy erkennt. 

BW ist jedoch nicht von BILD abhängig. Ihm kommt es 
lediglich darauf an, eine Datei vorzufinden, die die 4000 
Bytes eines 80*25-Zeichen-Textbildschirms in der Reihen- 
folge enthält, wie sie innerhalb des Video-RAMs dargestellt 
werden. Wenn Sie also mit einem anderen Hardcopy-Pro- 
gramm arbeiten möchten, steht dem grundsätzlich nichts im 
Wege. 


Aufbau von BW 


Das BW-Programm setzt sich aus zwei Dateien zusammen: 
die Include-Datei WORD.H (Listing I) und das eigentliche 
Programm in der Datei BW.C (Listing 2). In dieser Datei 
finden Sie eine Deklaration aller Strukturen innerhalb einer 
MS-Word-Datei, wie sie auf den vorhergehenden Seiten 
beschrieben wurden. Ebenfalls finden Sie dort die Deklara- 
tion der verschiedenen Bit-Felder, die die einzelnen Struk- 
turen beinhalten. Sowohl die Strukturen als auch die Bit- 
felder werden über den typedef-Befehl als eigenständige 
Datenstrukturen deklariert, wobei ihr Name mit dem 
Namen des korrespondierenden Objekts aus der MS-Word- 
Datei übereinstimmt. Diese Include-Datei eignet sich daher 
ideal als Basis zur Erstellung eigener Programme, die MS- 
Word-Dateien lesen, manipulieren oder erstellen. 

Eng verbunden mit dem BW-Programm ist auch die 
Druckformatvorlage SCREEN.DFV (Bild T), die die Vari- 
anten zur Formatierung der Hardcopy enthält. Da die 
erstellte Textdatei speziell auf diese Druckformatvorlage 
ausgerichtet ist und ihr Name innerhalb des Vorspanns der 
Textdatei angegeben wird, sollten Sie diese Druckformat- 
vorlage mit der Druckformatvorlage Ihres jeweiligen Textes 
verbinden, sofern Sie Hardcopies in den Text einbinden 
möchten. Der Befehl von MS-Word dazu lautet: Muster 
Übertragen Zusammenführen. 

Die Hardcopy selbst wird als ein Absatz erstellt, der mit 
der Absatzvariante SC formatiert wird. Die einzelnen Zei- 
chen werden je nach ihrer Farbe mit unterschiedlichen 
Attributen versehen. Inverse Zeichen werden kursiv darge- 
stellt, helle Zeichen durch das Attribut »fett« hervorgeho- 
ben und unterstrichene Zeichen im Ausdruck ebenfalls 
unterstrichen. 

Einige Zeichen müssen bei der Umwandlung in eine 
MS-Word-Datei umgesetzt werden, da Sie von MS-Word in 
besonderer Weise interpretiert werden und deshalb nicht 
im Text auftauchen sollten. Dies gilt für das Zeichen mit 
dem Code 9 (Tabulator) und für das Zeichen mit dem Code 
31, das ebenfalls umgesetzt werden muß, da es von MS- 
Word sonst als bedingter Trennstrich betrachtet wird. 

Über die einfache Umwandlung der Hardcopy hinaus 
bietet BW die Möglichkeit, die Hardcopy mit einem ein- 
fachen oder einem doppelten Rahmen zu umgeben. Erste- 
res wird als Defaulteinstellung vorgegeben. 
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Include-Datei : WORD.H 

zum Zugriff : auf die Strukturen innerhalb 
einer MS-Word-Datei 

erstellt an : 12.02.1988 


letztes Update an: 12.82.1988 


(Copyright) : 1989 by MICHAEL TISCHER 
le and GÜNTER JÜRGENSMEIER 


/*-- Kompilierungs-Befehle 
/pragma pack(1) /* Strukturen byteweise packen */ 
/#== Konstanten ===============2s@0==2samseeoseoeooeenennnnee/ 
#define PAGELEN 128 /* Länge einer Page innerhalb der Datei */ 
/#== skalare Typedefs =»==n===ossu2sSs=nneussunenenseunneennen/ 
/* wir basteln uns ein BYTE */ 

/%* dito: WORD %#/ 


/* ein DWORD */ 
/* NEAR-Pointer auf Char */ 


typedef unsigned char BYTE; 
typedef unsigned int WORD; 
typedef unsigned long ULONG; 
typedef char near * CNP; 


/#== Typedefs der Bitfelder =========u-==-222s222szenosunuuuneH/ 


/* Bit-Feld für bvRev im Vorspann der Datei 


pret struct 


BYTE fMarkRev : 


RevText 
RevBar 
Dummy 

} BFREV; 


sel struct 
BYTE fStyled : 
ste B 


reset struct 
BYTE fBold 


fltalic : 


ftc 
} CHPBF2; 
typedef struct 
BYTE fUline 
fStrike 
fDline 


fNew 
csa 


fHidden 
} CHPBF3; 


KIDeBet struct 


BYTE fStyled : 


ste 
} PAPBF1; 


Preat struct 


Sr IKee 


fKFollow : 


fSBS 
dumny 
} PAPBF2; 


Listing 1: WORD.H 


fSpecial : 


/%* Veränderungen merken, Ja/Nein 
/* Attribut für veränderte Zeichen 
/* Position der Korrekturleiste 
/* ungenutzt 


/* Bit-Feld für CHPBFI aus FPROPC 


/* 1 = mit Muster formatiert 
/* Nummer der Zeichen-Variante 


/* Bit-Feld für CHPBF2 aus FPROPC 


/#* 1 = Zeichen ist fett 
/* 1 = Zeichen ist kursiv 
/* Font-Nummer 


/* Bit-Feld für CHPBF3 aus FPROPC 


/* 1 = Zeichen ist unterstrichen 

/* 1 = Zeichen ist durchgestrichen 
/* 1 = Zeichen ist doppelt-unterstr. 
/* 1 = Zeichen wurden einge 

/* Großschrift, Kapitälchen? 

/* 1 = Zeichen ist (Seite),... 

/* 1 = Zeichen ist versteckt 


/* Bit-Feld für PAPBFi aus FPROPP 


/#* 1 = mit Muster formatiert 
/* Nummer der Absatz-Variante 


/* Bit-Feld für PAPBF2 aus FPROPP 


/* Ausrichtung des Absatz 

/* 1 = Absatz selbe Seite 

/* 1 = folgender Absatz selbst Seite 
/* 1 = nebeneinander 

/* reserviert, enthalten 8 


% 
% 
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jpaäer struct 

BYTE level : 
fHidden : 

} PAPBF3; 

ee struct 

BYTE fBottom : 
fOdd : 
fEven 
fFirst 
bte 
bsc 

} PAPBF4; 

Dress struct 

BYTE fBorderLeft 
fBorderRight 
fBorderAbove 
fBorderBelow 
dunmy 

} TYFRAME; 

zpeder struct 


BYTE jcTab : 3, 
Ace Wr 


dunny 
} TBDBF1; 
great struct 
BYTE fStyled : 1, 
ste SUR 
} SEPBF1; 
typedef struct 


BYTE bkc : 3, 
nfcPgn : 3, 


dummy 
} SEPBF2; 
gpeder struct 


2; 


#define REV 


#define REV_TEXT_BOLD 3 
#define REV_TEXT_DUP UNDER 6 


#define REV_BAR_NO 
#define REVBAR_LEFT 


#define REV_BAR_ALTERNATE 3 


#define JC LEFTT 8 
#define JC_CENTER 1 
#define JC_RIGHT 2 
#define JC_BOH 3 


/* Bit-Feld für PAPBF3 aus FPROPP */ 


/* Nummer der Gliederungsebene “/ 
/* 1 = Gliederungsebene ausgeblendet #/ 


/®* Bit-Feld für PAPBF4 aus FPROPP */ 


1 = Kopf-, 8 = Fußzeile */ 
1 = auf ungeraden Seiten */ 
1 = auf geraden Seiten */ 
1 = auf der ersten Seite */ 
/% Rahmentyp “/ 
/* Rahmenattribute 


/* Bit-Feld für TYFRAME aus FPROPP 


/* 1 = Linie links 

/* 1 = Linie rechts 

/#* 1 = Linie oben 

/* 1 = Linie unten / 
/* reserviert, enthalten # */ 


/* Bit-Feld für TBDBFi aus TBD */ 
/* Ausrichtung des Tabulators */ 
/* Füllzeichen “/ 
/* reserviert, enthalten 8 “/ 
/* Bit-Feld für SEPBF1 aus SEP 
/#* 1 = mit Muster formatiert 
/* Nummer der Bereichs-Variante 
/* Bit-Feld für SEPBF2 aus SEP 
/* Bereichswechsel 
/* Format der Seitennummer 
/* reserviert, enthalten 8 
/* Bit-Feld für SEPBF3 aus SEP 
/* reserviert, enthält 8 
/* reserviert, enthält 8 


/* 1 = Zeilennummern drucken 
/* 1 = Fußnoten am Ende des Textes 


Codes für RevText in BFREV (VORSPANN) */ 

#define REV_TEXT_UNDERLINE 8 

#define REV_TEXT_UPPERCASE 1 
"TEXT_NORMAL 


/* unterstrichen %/ 
/* Großbuchstaben */ 
2 /* kein besonderes Attribut ®/ 

/* fett */ 
/* doppelt-unterstrichen */ 


Codes für RevBar in BFREV (VORSPANN) */ 
[) /* keine Korrekturleiste %*/ 
1 /%* Leiste links */ 
2 /* Leiste rechts */ 
/%* abwechselnd links rechts */ 


Codes für csm in CHPBF3 (FPROPC) */ 
/* normale Schrift */ 

/* Großbuchstaben */ 

/* Kapitälchen %/ 


Codes für jc in PAPBF2 (FPROPP) */ 
/* linksbündig */ 
/* rechtsbündig */ 
/%* zentriert “/ 
/%* Blocksatz “/ 


Listing 1: (Fortsetzung) 


Wird die Hardcopy nicht mit einem Rahmen umgeben, 
werden am linken und rechten Rand jeder Zeile ein hartes 
Leerzeichen (ASCII-Code 255) erzeugt. Dies soll dazu 
beitragen, daß die Hardcopy zentriert werden kann, ohne 
daß MS-Word die verschiedenen Zeilen unterschiedlich 
einrückt, weil sie mit weichen Leerzeichen (ASCII-Code 32) 
beginnen oder enden. 

Darüber hinaus erlaubt BW die Erstellung einer Hard- 
copy zur Weiterverarbeitung durch das Schriftenpaket 
DocuJet, daß unter anderem den Ausdruck solcher Hard- 
copies inklusive der Bildschirmattribute auf dem HP-Laser- 
Jet ermöglicht. Beim HP-LaserJet gibt es jedoch die Beson- 
derheit, daß sich das Leerzeichen eines Fonts nicht umdefi- 
nieren läßt. Deshalb wird ein Leerzeichen von BildWord in 
den Code 127 umgesetzt, der von DocuJet zum Beispiel als 
reverses Leerzeichen definiert ist. Übrigens werden alle 
Ausgaben des Microsoft System Journals mit Microsoft 
Word und DocuJet bearbeitet. Alle Bildschirmabbildungen, 
die sie in dieser Ausgabe finden, sind mit den Programmen 
Bild und BildWord erstellt worden. 

Die einzelnen Optionen werden durch die Angabe spe- 
zieller Kommandozeilen-Parameter beim Aufruf von BW 
aktiviert. Hier eine Liste der akzeptierten Parameter, die 
wahlweise in Groß- oder Kleinschreibung angegeben wer- 
den können: 


Parameter Abkürzung Bedeutung 


/KEINRAHMEN /K kein Rahmen um die Hardcopy 


/RAHMEN /R einfachen Rahmen um die 
Hardcopy 

/DOPPELT /2 doppelten Rahmen um die 
Hardcopy 

/DOCUJET /D Ausgabe für DocuJet 


Die Namen der umzuwandelnden Dateien werden 
ebenfalls in der Befehlszeile angegeben. Sie können beliebig 
viele Dateinamen angeben, die einzelnen Namen dabei 
auch mit Wildcards (*, ?) versehen, um eine ganze Gruppe 
von Dateien zu erfassen. Geben Sie dabei keine Datei- 
erweiterung an, geht BW von der Erweiterung .BLD aus, 
die bei BILD-Dateien automatisch vorliegt. Die erstellten 
Dateien tragen den gleichen Dateinamen wie die Ur- 
sprungsdateien, werden jedoch mit der Erweiterung .TXT 
versehen, die sie als MS-Word-Dateien kennzeichnen. 


Die Arbeitsweise von BW 


Die Arbeitsweise von BW zeigt einige grundlegende 
Schwierigkeiten auf, die es bei der Erstellung von MS- 
Word-Dateien zu meistern gilt. Das größte Problem dabei 
ist, daß die Informationen bei der Verarbeitung der 
Eingabedaten (hier der Hardcopy-Datei) nicht in der 
gleichen Reihenfolge anfallen, wie sie innerhalb der MS- 
Word-Datei gespeichert werden. 
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Das beginnt bereits beim Vorspann der Datei. Viele der 
Informationen, die hier verzeichnet werden (wie etwa die 
Page-Nummer der Absatz- und Bereichs-Formate), ergeben 
sich erst während der Erstellung der Datei, dann nämlich, 
wenn der jeweils vorhergehende Teil der Datei abgeschlos- 
sen und dadurch festgestellt wurde, wieviele Pages er belegt. 
Um aber den Text in die Datei schreiben zu können, muß 
zuerst der Vorspann ausgegeben werden, damit der Text 
mit der zweiten Page beginnt. 

BW bebhilft sich hier mit einem Trick, indem es zunächst 
eine Dummy-Page als Vorspann in die Datei schreibt und 
erst nach der Erstellung des Textes und der Formatinfor- 
mationen zum Anfang der Datei zurückkehrt und den 
Dummy-Vorspann durch den richtigen Vorspann über- 
schreibt. 

Nicht so einfach ist das Problem zu lösen, daß beim 
Durchlaufen der einzelnen Zeilen und Spalten der Hard- 
copy sowohl die auszugebenden Zeichen (also der Text), als 
gleichzeitig auch die zugehörigen Formatinformationen 
anfallen. Während erstere direkt in die Textdatei geschrie- 
ben werden können, müssen letztere zunächst zwischenge- 
speichert werden, um erst nach der Ausgabe des letzten 
(Text-) Zeichens in die Datei geschrieben zu werden. 

In diesem Zusammenhang kommt der Funktion 
StoreFormat() eine entscheidende Bedeutung zu. Ihr 
nämlich werden von der Funktion WriteChAt( ) (Ausgabe 
eines Zeichens mit dem entsprechenden Attribut) die For - 
matting Properties der Zeichen (FPROPCs) überge- 
ben, die beim Durchlaufen der Zeilen und Spalten 
»anfallen«. StoreFormat( ) trägt diese Informationen in 
eine Page mit Zeichenformaten (FPAGE) ein, die später in 
die Textdatei geschrieben wird. Da nicht vorherzusehen ist, 
wie viele dieser FPROPCs und damit wieviele Pages erstellt 
werden müssen (das hängt von der Entropie, also der 
Mischung der verschiedenen Attribute in der Hardcopy- 
Datei ab), speichert StoreFormat( ) die einzelnen Pages 
in einem großen Puffer ab, den es über den Heap allokiert. 

Immer, wenn eine Page voll ist, vergrößert es den Page- 
Puffer um eine neue Page und hängt die neue Page an sein 
Ende an. StoreFormat( ) weist damit den Charakter 
einer zentralen Verwaltungsinstanz auf. Während dies im 
Hinblick auf Organistionen und Behörden oft nicht gerade 
zu einer Steigerung der Effizienz beiträgt, bringt dies hier 
jedoch Vorteile mit sich. Dazu zählt vor allem, daß Store- 
Format( ) jederzeit weiß, welche Formate (in Form der 
FPROPCs) es bereits in einer Page angelegt hat und 
dadurch feststellen kann, ob der übergebene FPROPC 
bereits in der Page gespeichert wurde. In diesem Fall kann 
auf die Aufnahme dieses FPROPCs in die Page verzichtet 
werden, und es muß statt dessen nur ein neuer FOD mit 
einem Pointer auf den bereits existierenden FPROPC ange- 
legt werden. Dies trägt dazu bei, den Gesamtumfang der 
erstellten Datei möglichst klein zu halten und erhöht 
dadurch vor allem bei großen Dateien die Performance von 
MS-Word bei der Verarbeitung der Datei. 
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Codes für btc in PAPBF4 (FPROPP) 
/* kein Rahmen um Absatz 

/* kompletter Rahmen 

/* Rahmentyp in tyfrane 


Codes für bsc in PAPBF4 (FPROPP) 
/* einfacher Rahmen 

/* doppelter Rahnen 

/* einfacher Rahmen fett 


Codes für jcTab aus TBDBF1 (TBD) 
/* links 

/* zentriert 

/* rechts 

/* Dezinal-Tabulator 


Codes für tlc aus TBDBFi (TBD) 
/* Leerzeichen 

/* Punkte 

/* Bindestriche 

/* Leerzeichen unterstrichen 


Codes für bks aus SEPBF2 (SEP) 
/* fortlaufend 

/* spalte 

/* gerade 

/* ungerade 


/ 

#define BTC_NO BORDER 8 
#define BTC_BOX 1 
#define BTC SELECT 2 


#define BSC_SINGLE 8 
#define BSCDOUBLE 1 
#define BSCBOLD 2 


define TLC_WHITE 
#define TLC_DOTS 
Zdefine TLC_HYPHENS 
#define TLC_UNDERLINE 


/ 

#define BKS_LINE 
#define BKS_COLUMN 1 
#define BKS_RECTO 2 
#define BKS_VERSO 3 


Codes für nfcPgn aus SEPBF2 (SEP) 
/* arabische Ziffern 

/* lateinische Schreibw., groß 
/* lateinische Schreibw., klein 
/* in korten, groß 

/* in Worten, klein 


%/ 


[Uesnsnnnnnnssennunnnnnnunennennnennnnnnnnunnunuuunnnunemunnn/ 


/* Vorspann einer MS-Word-Datei 


/* Identitätscode, 48689 

/* reserviert, muß 8 enthalten 

/* muß 43776 enthalten 

cReceipts; /* reserviert, muß @ enthalten 
cbReceipts; /* reserviert, muß 8 enthalten 
bReceipts; /* reserviert, muß 8 enthalten 
isglac; /* reserviert, muß 9 enthalten 
/* Anzahl der Zeichen + 128 

/* Page-Nummer: Absatz-Fornate 

/* Page-Nummer: Fußnoten-Tabelle 

/* Page-Nummer: Bereichs-Beschreiber 

/* Page-Nummer: Bereichs-Tabelle 

; /* Page-Nummer: Druckseiten-Tabelle 
pnSund; /* Page-Nummer: Infos über Text 
szSsht[66]; /* Name der Druckformatvorlage 
/* pnMac für MS-Write 

/* Name des Druckertreibers 

/* Anzahl der Pages 

/* Veränderungs-F a 

/* bisher ungenutz 


sg struct 


/* Format Descriptor (FOD) 


mens struct 


/* erstes nicht mehr beschriebenes Z. 
/* Offset zum zugehörigen FPROP 


ULONG 
WORD 
} FOD; 


fcLin; 
bfprop; 


/* eine Page mit Zeichen- 
/* oder Absatzformaten 
/* erstes beschriebenes Zeichen 
/%* maximal 28 FODs 
/* zum Auffüllen auf 128 
/* Anzahl der FODs in dieser Page 


re struct 


fcFirst; 
rgfod[28]; 
dunny[3]; 
cfod; 


Listing 1: (Fortsetzung) 


% 


% 
*/ 


Das MS-Word-Dateiformat 


ETERB struct 


cch; 

chpbf1; 

chpbf2; 
Ss; 
pbf3; 


hpsPitch; 


hpsPos; 


gredef struct 


WORD dxa; 
TBDBF1 tbdbf]; 
char chAlign; 
} TBD; 


Drenet struct 


cch; 


papbfl; 
papbf2; 
stcnora; 


Apeset struct 
ULONG cpRef; 
ULONG cpFtn; 
} FND; 

Kreier struct 
WORD ciänd; 


WORD cfndMax; 
FND rgfndL 1]; 
} FNTB; 


Hai struct 


/* Formatting Property mit 
/* Character Property (FPROPC) 
/* Anzahl der Bytes in diesem FPROP-1 
/* Zeichenauster 
/%* Zeichen-Attribute 
/* Font-Größe in halben Punkten 
/* weitere Zeichen-Attribute 
/* reserviert, muß 8 enthalten 
/* normal/hochgestellt/tiefgestellt 


/* Tabulator Descriptor (TBD) 


/* Abstand vom linken Rand 
/* Attribute des Tabulators 
/* Zeichen für Dezimaltabulator 


/* Formatting Property nit 
/* Paragraph Property (FPROPP) 
/* Anzahl der Bytes in diesem FPROP-1 
/* Absatzmuster 
/* Absatz-Attribute 
/* Zeichenmuster für std. Zeichen 
/* weitere Zeichen-Attribute 
/* rechter Einzug 
/* linker Einzug 
/* linker Einzug erste Zeile 
/* Zeilenabstand 


/* Anfangsabstand */ 


/* Endeabstand 

/* weitere Absatz-Attribute 
/* Rahmentyp 

/* reserviert, enthalten 8 


/* maximal 28 TBDs */ 


/* Footnote Descriptor (FND) 


/* Position der Fußnotenrefernz 
/* Position des Fußnotentextes 


/* Footnote Table (FNTB) 


/* Anzahl der Fußnoten 
/* reserviert 
/* Array mit Fupnotenbeschreibern 


/* Section Property (SEP) 


/* Anzahl der Bytes in diesem SEP-1 
/* Bereichsmuster 

/* Bereichsattribute 

/% See 

/* Seitenbreite 

/* Nummer der ersten Seite 

/* oberer Rand 

/* Drucklänge 

/* linker Rand 

/* Druckbreite 

/* weitere Attribute 

/* Anzahl der Spalten 

/* Y-Position Kopfzeile 

/* Y-Position Fußzeile 

/* Spaltenabstand 

/* Breite des Bundstegs 

/* Y-Position der Seitennummer 
/* X-Position der Seitennummer 


/* Abstand der Zeilennummern von links 


/* Zeilennumsern-Intervall 


Listing 1: (Fortsetzung) 


% 


“/ 


/* Secton Descriptor (SED) 


ppedef struct 


/* Offsetposition des Bereichs-Endes 
/* reserviert 
/* Offsetposition des SEP 


ULONG cp; 
WORD fn; 
ULONG fcSep; 
} SED; 


KrpeMet struct /%* Section Table (SETB) 
/* Anzahl der Bereiche 
/* reserviert 

/* Array mit SEDs 


csed; 
WORD csedMax; 
SED rgsed[ 1]; 
} SETB; 


lage struct 


WORD pen; 
ULONG cpMin; 
} PCD; 


/* Page Descriptor (PGD) 

/* Nummer der Seite 

/* Offsetadresse des ersten Zeichens 
/* Page Table (PGTB) 

/* Anzahl der Druckseiten 


/* reserviert 
/* Array mit PGDs 


Prpeset struct 


WORD cpgd; 
WORD cpgdlac; 
PGD repgdl1]; 
} PGTB; 

pypeder struct /* Informationen über den Text 
oTitle; 
oAuthor; 
oOperator; 
oKeywords; 
oComments; 
oVersion; 
dRecision; 
dCreation; 


/* Titel des Textes 
/* Autor 
/* Sachbearbeiter 
/* Schlüsselwörter 
/* Kommentare 
/* Versionsnummer 
/* Modifikations-Datum */ 
/* Erstellungs-Datum */ 
/* Anzahl der Zeichen im Text */ 


Listing 1: (Ende) 


Jedoch wird StoreFormat( ) nicht genutzt, um jedes 
Zeichen mit einem eigenen FPROPC zu versehen, da wir bei 
der Beschreibung des MS-Word-Dateiformats gesehen 
haben, daß ein FPROPC immer nur für ein Gruppe von Zei- 
chen mit gleichem Attribut angelegt wird. Die Entschei- 
dung, ob ein neuer FPROPC angelegt wird, fällt dabei nicht 
StoreFormat( ), sondern die Funktion WriteChAt(), 
die zur Ausgabe eines Zeichens in die Datei aufgerufen 
wird. 

Um eine Veränderung des Zeichenformats erkennen zu 
können, speichert sie das Format des jeweils letzten Zei- 
chens in der globlaen Variablen oldstyle ab. Wird ihr bei 
ihrem Aufruf dann ein Zeichen übergeben, das mit einem 
anderen Format versehen werden muß als es in oldstyle 
verzeichnet ist, erkennt sie den Formatwechsel. Sie ruft 
dann StoreFormat( ) auf, um einen FPROPC für die vor- 
angegangenen Zeichen zu speichern. 

Da der FPROPC dadurch immer erst im nachhinein 
angelegt wird, ist es übrigens erforderlich, daß StoreFor - 
mat( ) unter Umgehung von WriteChAt( ) nach der Bear- 
beitung aller Zeichen noch einmal aufgerufen wird, um 
einen FPROPC für das Format der letzten Zeichen zu spei- 
chern. 
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DT re 


sr length 11”; width 8,5". K 1% a EArebler 1 
" " 'orma' c 
ver Kutle j"? Jeft Örr right ’ör. Toptrmaiag hendrat 0,5". 
same page. 


ee / 


BILDWORD (BMW. 


: Konvertiert Hardcopy-Dateien, die 
nit dem Programm BILD erstellt wur- 
den, in MS-Word-Dateien. 


„BREI Footnotes on same 
Be (wodern a) 12. Flush left, space after 0,5 li (keep 
in one column 

$0 Character 18 NORMAL 
CourierSeriesIl (modern a) 12. 

$1 Character 19 

® AEOmeSSESBE naeh (modern a) 12 Bold. 

CourierSeriesIl (modern a) 12 Underlined. 
$3 Character 2] 
CourierSeriesIl (modern a) 12 Bold Undertind" 
$4 Character 
CourierSeriesII (modern a) 12 Italic. 
55 Character 
CourierSeriesIl (modern a) 12 Bold Italic. 
S6 Character 24 REV 
CourierSeriesIl (modern a) 12 Italic Underlined. 
10 $7 Character 25 INTER REV 
CourierSeriesIl (modern a) 12 Bold Italic Underlined. 


Autoren : GÜNTER JÜRGENSMEIER 
MICHAEL TISCHER 

Version : 2.18 

entwickelt am : 14.03.1986 

letztes Update : 12.02.1989 


HELLTE 
link ° OR "bursLiBf\setargv; 


: 1989 by GÜNTER JÜRGENSMEIER 
and MICHAEL TISCHER 


Bild 1: Die Druckformatvorlage SCREEN ..DFV. /#== Inelude-Dateien einbinden 


include "word.h” /* Strukturdefinitionen für Word-Datei */ 
In der Art von StoreFormat( ) kann man sich natür- retten est 


lich auch eine Funktion schaffen, die nicht die Zeichen-, |finclude <fentl.h> 
#include <10.h> 


sondern die Absatzformate verwaltet, um sie nach der Bear- <sys\types.h> 
beitung aller Zeichen auszugeben. Innerhalb von BW ist fee 
dies jedoch nicht erforderlich, da der Aufbau der Page mit <nenory.h> 


den Absatzformaten von der Hardcopy und den Attributen |“tnelude <string.h> 


der darin gespeicherten Zeichen unabhängig ist. Grund- |/*-- Konstanten 
sätzlich besteht die erstellte Datei aus zwei Absätzen: Dem |ygerine FALSE 


ersten Absatz mit dem Muster SC, der die eigentliche |sdefine TRUE /* der Wahrheit auf der Spur 
Hardcopy und damit alle Zeichen aus der Datei enthält und |ygefine TAB /" Tabulator 
einen zweiten Absatz, der ihm nachfolgt und leer ist - 

s.2e ö S . /* Zeilenumbruch 
dadurch lediglich die Endemarke enthält. Dieser Absatz /* Absatzende 


/* weicher Trennstrich 


wird mit dem Format für den Standardabsatz versehen. Hletins HSPROEN 355 Zn PRstee Latrastchen 


Darüber hinaus schreibt BW keine weiteren Informatio- 
. . n - 3 a OR EN define PSCREEN 87 /* Variantennr. Hardcopy-Absatz 
nen in die Datei. Eine Fußnoten a Bereichs-, oder Sei #define CSCREEN 28 /* Basisnummer der Zeichenvariante 
tenumbruchstabelle wird also nicht angelegt, wie man auch N a N 
. . %*- Konstanten zur Berechnun er Zeichen-Varlantennr. 
nach Bereichsbeschreibern und der Inhaltsangabe vergeb- 8 6 


lich suchen wird. Wenn Sie noch weitere Fragen zu den : ae /* Imanalı ad Br 
Pr . ”n . . richen 
Abläufen innerhalb von BW haben, möchten wir Sie an das N N AT Beet 


Listing dieses Programms verweisen. Es ist vollständig #define NOTSTYLED 255 /* noch kein Style-Code ermittelt 
dokumentiert und sollte Ihnen deshalb kein Geheimnis define BILD FILE ”.BLD”" /* Dateierweiterung BILD-Dateien 

ö ie Si ö #define WORD FILE "TXT" /* Dateierweiterung Word-Dateien 
verbergen können. Wie Sie das Programm erstellen können, lerne Dey “SCREEN” “ /# Nane der orte g. 
entnehmen Sie bitte dem Kopf der Datei BW.C. 

Beachten Sie bei der Erstellung des Programms, daß das 
Modul setargv.obj beim Linkvorgang mit BW verbun- |zdefine ELVEK(x) ( sizeof(x) / sizeof(x[B)) ) 
den werden muß. Seine Aufgabe ist es, noch vor dem Auf- |,... strukturen 
ruf der Funktion main( ) und damit vor dem Start des Pro- 


/%#-- Makros 


/* beschreibt ein Zeichen-Attribut 


gramms alle Dateien zu ermitteln, die auf die in der Kom- { /* aus dem Video-RAM 

mandozeile genannten Namensmuster (zum Beispiel : 3; et 
*.BLD) passen und diese Namen innerhalb des Vektors : 3; /* Hintergrundfarbe 
argv zu übergeben. Dem Programm erwächst dadurch der 2 VNEREINREN BEL 
Eindruck, als seien die Namen dieser Dateien in der Kom- 

mandozeile angegeben worden und es muß diesen Vorgang |g"Vet SCREEN se RE rk 


nicht in eigener Regie durchführen. BYTE ch; /®* ASCII-Code des Zeichens 
Für Windows-Entwickler sei hier noch angemerkt, daß |,*t"uet ÄTTRIBUT at; air one 

das Dateiformat von Windows Write in den wesentlichen 
Punkten mit dem von Word übereinstimmt. 
Günter Jürgensmeier / Michael Tischer Listing 2: BW.C 


28 Microsoft System Journal März/April 1989 


Das MS-Word-Dateiformat 


struct KZP /* beschreibt einen Kommandozeilen-Parameter */ 


char *befehl, /* Name des Parameters ohne '/’ */ 
*shortcut; /* Abkürzung ebenfalls ohne '/'*/ 
BYTE *flag, /* Adresse des zugehörigen Flags */ 
wert; /* Wert für das Flag */ 


RER RAHMEN /* enthält die Rahmenzeichen */ 


char chVert, /* vertikaler Strich #/ 
chHoriz, /* horizontaler Strich */ 
chUL, /* obere linke Ecke */ 
chUR, /* obere rechte Ecke */ 
chLL, /%* untere linke Ecke %*/ 
; chLR; /* untere rechte Ecke */ 


/*-- globale Variablen */ 


BYTE rahmen = 1, /* Rahmen um das eg ziehen? */ 
docujet = FALSE; /* nicht für Docujet? */ 


struct SCREEN scr[25][82]; /* nimmt Hardcopy-Datei auf */ 
struct RAHMEN *rptr; /* Pointer auf die Rahmenzeichen */ 


int handle; /* Handle für Dateizugriff 
ULONG pos; /* Position innerhalb des Ausgabe-Datei 
BYTE oldstyle; /* Attribut-Code letztes Zeichen 


int anzpage; /* Anzahl der allokierten Pages für FPROPCs 
void *pptr = (void *) 8; /* Pointer auf allokierte Pages 


/%*-- Funktionen 


Pa na aaa N 
:NritePage 


: Schreibt eine 128-Byte-Page in die 
Ausgabe-Datei 
Eingabe-Parameter: PAGE = Pointer auf die Page 
Return-kert : keiner 
Info : - Das Handle der Ausgabedatei mup in der* 
ereeheh Variablen HANDLE verzeichnet : 
sein 
- Tritt bei der Ausgabe ein Fehler auf, * 
wird die Programmausführung abgebr. * 


BEE N NN IE EEE N N NE EEE EN N EN BE 


%* 
%* 
* 
* 
%* 
%* 
* 
* 


void WritePage( BYTE * page ) 
{ /* die Page in die Ausgabedatei schreiben */ 
if ((write(handle, mie; PAGELEN)) t= PAGELEN) 
{ /* die Page konnte nicht geschrieben werden */ 
Bene andere Fehler bei Schreiben in Ausgabedatei.\n"); 
exit( 1 /* das Programm mit Fehlercode beenden */ 


} 
ps += PAGELEN; /* alles o.k. Positionsz. inkrementieren */ 


3 Pe a EEE NEE EEE BE 
:WriteVorspann 


Aufgabe : Gibt den Vorspann der Datei nach dem 
Abschluß der Zeichenkonvertierung aus. 

Eingabe-Parameter: CPOS = Offsetadresse des letzten 
Text-Zeichens innerhalb der 


Datei. 
PAPOS = Offsetadresse innerhalb der 
Datei, an der die Absatzfor- 
mate beginnen. 
Return-kert : keiner 
Info : - Tritt bei der Ausgabe ein Fehler auf, 


wird die Programmausführung abgebr. 
HERE NEN IN HE NENNEN N HB NENNEN BEDENKEN BEE EEE EEE DENE NENNEN NENNE 


KEKKEKKKKEK KK 
DE Ze Ze ze Zu Z> Ze 22 Ze zu ze; 


PN WriteVorspann( ULONG cpos, ULONG papos ) 
VORSPANN vorspann; /* Struktur bildet Page 78 nach */ 


Listing 2: (Fortsetzung) 


menset( &vorspann, '\8’, sizeof( vorspann ) ); /* alle F. 8 


vorspann.wIdent = 48689; /* Identitätscode * 


vorspann.wTool = 43776; /* noch ein Identitätscode 
vorspann.fcMac = cpos; /* Anzahl Textzeichen + 128 


vorspann.pnPara = ((papos +127) >> 7); /*Page-Nr. Absatz-F. 


/* keine Fupnoten 

/* keine Bereichsbeschreiber 

/* keine Bereichstabelle 

/* keine Seitenumbruchs-Tabelle 

/* keine Informationen über den Text 
((pos + 127) >> 7); /* Anzahl Pages ges. 


vorspann.pnfntb 
vorspann. Pesse 
vorspann.pnSetb 
vorspann.pnPgtb 
vorspann.pnSumd 
vorspann.pnMac 


/*-- Namen der Druckformatvorlage Eee 
memcpy(vorspann.szSsht, DFV, sizeof(DFV)); 


lseek( handle, BL, 8 ); /* File-Pointer an den Anfang 
uni. (BYTE *) &vorspann ); /* den Vorspann ausgeben 


% 
“ 


ana ee MN EEE 


* Funktion :StoreFormat 


Aufgabe : Speichert das Format einer Gruppe von 
Zeichen. 
* Eingabe-Parameter: FPTR = Zeiger auf einen FPROPC 
* LEN = Anzahl der Bytes im FPROPC 
* exklusive Feld cch 
* POS = Position des Zeichens hinter 
* dem letzten Zeichen der Gruppe 
* Return-kert : keiner 
* 


AR BRD DI DE EEE N EN EEE DE ED DD NE BE BENENNEN 


StoreFormat( FPROPC *fptr, int len, ULONG pos ) 


static FPAGE *ap; /* Ptr auf die aktuelle Page 
static int sum; /* Anzahl der Bytes in der Page 
static BYTE *ptr; /%* zeigt auf Position für FPROPC 
ULONG last; "ya letztes Zeichen in einer beendeten Page 
register int i; /* Schleifenzähler 

*]ptr; /%* Laufzeiger auf die einzelnen FROPCs 


" ( pptr == (void *) 8 ) /* noch kein Puffer NT 
* Nein 

pptr = malloc( PAGELEN ); /* eine Page allokieren 
1 ( pptr == (void *) 8) /* kein Speicher? 


En Zu wenig Speichert\n”); 
exit( 1 /* Programm mit Fehlercode beenden 


s- /* Page konnte allokiert werden 
anzpage = 1; /* bisher eine Page allokiert 
ÜFPAGE *) pptr; /* aktuelle Seite 

sum = sizeof(ap->cfod) + sizeof(ap->fcFfirst); 
ap->cfod = ß; /* noch keinen FOD in der P: 
ptr = &(ap->cfod); /* Position für FPROPC 
la = 128; /* Page beginnt mit ersten Zeichen 


} 
fptr->cch = len; /* Länge des FPROPCs speichern 


“ 
*/ 


e %/ 


%/ 
*/ 


* 


/*- paßt noch ein FOD und zugehöriger FPROPC in die Page? --*/ 


if (sum + len + 1 + sizeof(FÖD) > PAGELEN) 

{ /* Nein, Page-Buffer vergrößern 
last = ap-Irgfodlap->cfod-1).fcLin; /* letztes Zeichen 
3 = realloc( pptr, er * PAGELEN ); 

f ( pptr == (void *) /* genug Speicher? 
{ /* Nein 
ee Zu wenig Speichert\n”); 

exitt 1); /* Programa mit Fehlercode beenden 


else 
se nächste Page initialisieren 
= (FPAGE *) pptr+anzpage; /* aktuelle Seite 


Fanzpage; /* Anzahl der Pages inkrementieren 
sum = sizeof(ap->cfod) + sizeof(ap->fcFirst); 


Listing 2: (Fortsetzung) 


# 
“/ 


“/ 
% 


* 


%/ 
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RS = last; /* erstes Zeichen setzen void WriteChAt( BYTE zeichen, struct ATTRIBUT atr ) 
Are =; /* noch keinen FOD in der Page 
r= he /* Position für FPROPC /* Länge des FPROP */ 
: /* Nummer der Zeichen-Variante */ 
; FPROPC fpropc; /* Struktur mit Zeichen-Format */ 


/*-- FOD in die Page eintrag: if ((write(handle, &zeichen, 1)) != 1) /* Code schreiben */ 

sum += sizeof(FOD); /* Länge des FODs auf Summme addieren { /* das Zeichen konnte nicht geschrieben werden */ 

ap-Irgfodlap->cfod].fcLim = pos; /* letztes Zeichen BerEIKL Achtung! Fehler bei Schreiben In Ausgabedatei.\n"); 

if (len=39) /%* Standard-Zeichenformat? exit( 1); /* das Programm mit Fehlercode beenden %*/ 
Be a bfprop = BxFFFF; /* Ja } 

else /* Nein ++pos; /* alles o.k. Positionszähler inkrementieren */ 


{ 

/#*-- testen, ob bereits ein identischer FPROPC in der ---- /*-- Ist das Attribut des Zeichens mit dem des vorherigen --*/ 
/*-- Page gespeichert wurde a /#*-- identisch, müssen keine Attribut-Informationen ange- --*/ 
/#-- legt verden. --*/ 

for (i=8; i<Xap->cfod; ++i) /* die einzelnen FODs durchl. 
{ /* Pointer auf FPROPC erstellen und vergleichen style = GetStyleCode( atr ); /* Style-Code berechnen */ 

lptr = (BYTE *) Atap Srgtealll) + ap-Irgfod[i].b£prop; 
if ( memcap( fptr, Iptr, lent! ) ==) if ( style == oldstyle ) /* sind die Attribute identisch? */ 
break; /* einen identischen FPROPC gefunden return; /* Ja, zurück zum Aufrufer %*/ 


if ( 1 < ap-Icfod ) /* identischen FPROPC gefunden? ” /#*-- die Attribute sind nicht identisch, es muß ein neuer --*/ 
/* Ja, Offset zu diesem FPROPC speichern /®#-- FOD angelegt werden. Sf 
ap-Irgfodlap->cfod].bfprop = ap->rgfod[i].bfprop; 
else /* Ne if ( oldstyle == NORMAL ) Standard-Zeichenformat? */ 
{ StoreFormat( &fpropc, 8, pos-1 ); /* Zeichen-Format merken */ 
/*-- Position für FPROPC berechnen, BOT zu else /* nicht Standard-Zeichenformat */ 
/#-- rgfod[d] berechnen und schließlich FPROP { /* Varianten-Nummer merken */ 
/*-- kopieren. Inope: chpbf1.fStyled = TRUE; 
ptr -= ( len+ 1); /* Position berechnen */ Iron: .chpbfl.stc = BIGKETI® + CSCREEN; 
Depretcdfan-Serosl. bfprop = ptr-(BYTE *) ne StoreFormat( &fpropc, 1, pos-1 ); /*Zeichen-Format merken*/ 
sum += len + 1; /* Länge auf Gesamtlänge aufaddieren */ 
nencpy(ptr, fptr, len); /* FPROPC Fe Page kopieren */ 
} oldstyle = style; /* Style-Code merken */ 


} 
ee /* Anzahl der FODs in der Page inkrementieren */ 


4 N N 
:WritecChar 
[Pe EBENE RENNEN NEE 
:GetStyleCode Aufgabe : Schreibt ein Zeichen ohne besondere * 
Attribute in die Ausgabedatei * 
: Berechnet den Style-Code für ein Eingabe-Paraneter: ZEICHEN = ASCII-Code des Zeichens * 
* Zeichen. Return-Wert : keiner # 
* Eingabe-Parameter: ATR = Attribut des Zeichens aus dem Info : - Tritt bei der Ausgabe ein Fehler auf, * 
Video-RAM wird die Programmausführung abgebr. * 
* Return-Wert : Stylecode BRENNEN N / 
EN N BINNEN EN BR EBENE EEE BENENNEN NENNEN HE 
Fa KriteChar( char zeichen ) 


BYTE GetStyleCode( struct ATTRIBUT atr ) 
{ struct ATTRIBUT atr; /%* Attribut für WriteChAt() #/ 
BYTE style = NORMAL; /* der zu berechnende Style-Code */ 

atr.bg = FALSE; /% keine besonderen Attribute */ 


if (atr.in) /* intensive Farbe? */ atr.vg = FALSE; 

style I= INTENSE; /* Ja */ atr.in = FALSE; 

if (atr.vg==1 8% atr. bg==8) /* Zeichen unterstrichen? */ atr.bl = FALSE; 

style |= UNDERL; /# JA %/ WriteChAt(zeichen, atr); /* Zeichen über WriteChAt() ausg. */ 
else /* das Zeichen ist nicht unterstrichen #/ } 

if (atr.bg > atr.vg) /* ist das Zeichen invers? */ 


style i= INVERS; /# Ja */ [99 ala He NENNEN NEE 
:WritecCcharFornmat 

if ( oldstyle == NOTSTYLED ) /* noch kein Style-Code ber.? */ 

oldstyle = style; /* Nein, diesen Code merken */ 


Aufgabe : Schreibt die Zeichenfornate in die 
ie style; /* Style-Code zurückliefern #/ 


* 
* Ausgabedatei 
* Eingabe-Paranmeter: keiner 
* Return-Wert : keiner 
* Info : - Tritt bei der Ausgabe ein Fehler auf, 
wird die Programmausführung abgebr. 
HEHE HER NENNE EEE HE BEE BE DE EEE DE HEBEN DE EBENEN NEE DENE 
: Schreibt ein Zeichen in die Ausgabe- 
Datei und legt die zugehörigen Attribut-* void WriteCharFormat( void ) 
Informationen an. “ t 
Eingabe-Parameter: ZEICHEN = Code des Zeichens register BYTE * 1ptr; /* Laufzeiger */ 
ATR = Attribut aus Video-RAM int 1; /* Schleifenzähler */ 
Return-Kert : keiner /#-- die einzelnen Pages im Speicher durchlaufen */ 
Info : - Tritt bei der Ausgabe ein Fehler auf, for ( lptr = (BYTE *) pptr, 1 =; 


wird die Programsausführung abgebr. 1 <anzpage; 
ED BE DDR EBEN BENEHH N  NE +1, lptr += PAGELEN ) 
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KritePage( Iptr ); /* die Page ausgeben */ /#-- zu erstellende Datei öffnen 
strcpy( strrehr( name, '.' )+1, WORD FILE ); 
/* Speicher wieder freigeben */ if ((handle = re O_CREAT | O_BINARY | 


free( pptr ); iR 
ä O_WRONLY,S_IREAD |"S_IWRITE)) < 8) 


„pptr = vold’x) ß; /* kein Puffer allokiert */ f O_TRUNC 


printf(” Achtung! Ausgabedatei kann nicht erstellt" 
RO "werden. n” ) s 
* Funktion :WriteParaFormat air FALSE; /* mit Fehlercode zurück 
*% 
* : Schreibt die Absatzformate in die 
% Ausgabedatei. printf(" ---> %s”, name ); /* Namen der Ausgabedatei ausg. 
* Eingabe-Parameter: CPOS = Offsetadresse des letzten pos = 8; i /* im ersten Byte der Datei * 
* Text-Zeichens innerhalb der oldstyle = NOTSTYLED; /* bisher kein Style festgelegt 
* Datei. KritePage( (BYTE *) 8 ); /* Dummy-Vorspann schreiben 


* Return-Wert : keiner 
DENE NEIN N BRENNEN EN RN if ( rahmen ) /* Rahmen um das Hardcopy ziehen? 
/* Ja 


void WriteParaFormat( ULONG cpos ) /*-- obere horizontale Zeile ausgeben 

{ KriteChar( rptr->chUL ); /* obere linke Ecke 
FPAGE pas; /* eine Seite mit Formatinformationen for (i = 8; 1 < 82; i+*) /* horizontale Striche 
FPROPP *fptr = (FPROPP *) ((BYTE *) &page+125); WriteChar ( en ); 

WriteChar( rptr->chUR ); /* obere rechte Ecke 
page.cfod = 2; /* 2 Absätze befinden sich in dieser Datei WriteChar( LBREAK ); /* Zeilenumbruch 
page.fcFirst = 128; /* der Text beginnt mit Absatz #1 
page.rgfod[@].fcLim = cpos; /* und endet mit dem letzten Z. /*-- eine weitere Zeile ausgeben 
page.rgfod[8].bfprop = 121; /* Entfernung zum FPROPP KriteChar( rptr->chVert ); /* Zeichen für linken Rand 
page.rgfod[1].fcLim = cpos+t!; /* der zweite Paragraph be- for (1 = 8; 1 < 82; i++) /* diese Zeile ist leer 

/* steht nur aus der Enden. WriteChar(’ '); 
page.rgfod[1].bfprop = BxFFFF; /* Standardabsatz WriteChar( rptr->chVert ); /* Zeichen für rechten Rand 
WriteChar( LBREAK ); /%* Zeilenumbruch 
/*-- FPROPP für Absatz #1 anlegen } 
fptr->cch = 1; /* nur ein Byte im FPROP 
fptr->papbf1.fStyled = 1; /* Absatz mit Muster formatiert 
fptr->papbfi.stc = PSCREEN; /* Nummer der Variante /#*-- die 25 Zeilen des Hardcopies durchlaufen 
for (row = ; row < 25; row++) 
KritePage( (BYTE *) &page ); /* die Page ausgeben { /* ein Zeile bearbeiten */ 
} if ( rahmen ) /* Rahmen ausgeben? */ 
{ /" Ja */ 
WriteChar( rptr->chVert ); /* Zeichen für linken Rand */ 
[Pa Nee KENNER NENNEN WriteChar ( aD ); /* weiches Leerzeichen 77 
: Process File 
else /%* kein Rahmen */ 
ga : Eine Datei konvertieren WriteChar( HSPACE ); /* hartes Leerzeichen */ 
Eingabe-Parameter: NAME = Pointer auf den Dateinamen 
Return-Wert : TRUE, wenn die Datei konvertiert werden * /*-- die Spalten der Zeile durchlaufen */ 
konnte, sonst FALSE * for (col = 8; col < 88; col++) 
Info : Der übergebene Dateiname mup mit der * { /* eine Spalte bearbeiten */ 
Erweiterung BILD FILE versehen sein. * atr = scr[row][col].at; /* Attribut laden */ 
DEN NENNE EINEN NENNEN / zeichen = ser[rowlLeoll.ch; /* Zeichen laden */ 


BYTE ProcessFile( char * name ) /#*-- ASCII-Code des Zeichens feststellen und umwandeln -*/ 
switch ( zeichen ) 
#define SCL (sizeof(scr)) /* Größe des Bildschirmpuffers 
case '\B' » zeichen = ' '; /* NUL-Code %#/ 
register int i, j, /* Schleifenzähler break; 
row, /* bearbeitete Bildschirmzeile case TAB : zeichen = 'o'; /* Tabulator #/ 
col; /* Bildschiraspalte break; 
BYTE zeichen; /* das erges Zeichen case SHYPHEN : zeichen = 232; /* w. Bindestr. %*/ 
struct ATTRIBUT atr; /* Attribut des Zeichens break; 
FPROPC fpropc; /* Dummy-FPROPC } 
ULONG cpos, /* Offsetpos. Zeichen-Formate 
papos; /* Offsetpos. Paragraphen-Formate 
/#*-- bei der Konvertierung für die Arbeit mit DocuJet -*/ 
/*-- Eingabe-Datei öffnen /#*-- muß das reverse Leerzeichen umgesetzt werden / 
strupr( name ); /* String in Großbuchstaben umwandeln 
printf( "?%s”, name ); /* Dateinamen ausgeben if ( docujet && atr.bg && zeichen == ' ') 
if ( (handle = open(name, O BINARY | O_RDONLY)) < 8 ) zeichen = Bx7f; /* Bedingung erfüllt */ 
{ /* BLD-Datei konnte nicht geöffnet werden 
printf(” Achtung! Datei konnte nicht geöffnet werden.\n"); WriteChAt( zeichen, atr ); /* Zeichen ausgeben */ 
ao. FALSE; /* mit Fehlercode zurück */ } 


if ( rahmen ) /* Rahmen um das Hardcopy? */ 
/*-- Datei konnte geöffnet werden, u laden { /* Ja %*/ 
if ( read(handle, (void *) ser, SCL) t= SCL ) WriteChar( ' ' ); /* Leerzeichen ausgeben */ 
{ WriteChar( rptr->chVert ); /* rechten Rand ausgeben */ 
printf(” Achtung! Ungültige BLD-Datei.\n”); WriteChar ( ); /* Zeilenumbruch ausgeben */ 
return FALSE; /* nit Fehlercode zurück %*/ } 

} else /* kein Rahmen */ 
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4ER NN 


{ 
WriteChar( HSPACE ); /* hartes Leerzeichen */ * Funktion :ProcessArgs 
if ( row< 24 ) /* in der letzten Zeile? */ 
} HriteChar( LBREAK ); /* Nein, Zeilenumbruch ausgeben */ * Aufgabe : Argumente aus der Befehlszeile aus- 
* verten. 
} * Eingabe-Parameter: ARGC = Anzahl der Argumente 
* ARGV = Pointer auf den Vektor mit den 
if ( rahmen ) /* Rahmen um das Hardcopy ziehen? */ * Pointern auf die einzelnen Args 
{ /* Ja %*/ * Return-Wert : TRUE, wenn die Argumente o.k. sind, 
/*-- eine weitere Zeile ausgeben / * sonst FALSE 
WriteChar( rptr->chVert ); /* Zeichen für linken Rand */ * Info : den Eingaben des Aufrufers folgend wer- * 
for (i = 8; 1 < 82; it) /* diese Zeile ist leer */ * den die globalen Flags (RAHMEN, DOCUJET)* 
WriteChar( ' ' ); * geladen * 
WriteChar ( ri tr->chVert ); /* Zeichen für rechten Rand RENNEN IRRE BIENEN / 
HriteChar ( LEREAK ); /* Zeilenumbruch 
BYTE ProcessArgs( unsigned int argc, char **argv ) 
/#-- untere horizontale Zeile ausgeben 
HriteChar( rptr->chLL ); /* untere linke Ecke static struct KZP kzps[] = /* akzeptierte Parameter */ 
for (i = 8; i < 82; ir) /* horizontale Striche { 
WriteChar ( RE ); { "KEINRAHMEN”, ”K”, &rahmen, 8 
WriteChar( rptr->chLR ); /* untere rechte Ecke { "RAHMEN”, "R”, &rahmen, 1 }, 
} | "DOPPELT”, "2”, &rahmen, 2 


"DOCUJET", "D", &docujet, TRUE 
WriteChar( CR ); /%* Absatzende ausgeben }; 
WriteChar( LF ); static struct RAHMEN einfach= {'|', '-", ', ', br, ru}, 
doppelt= £? ae Im, 'r', is WR N s’); 


}, 
} 


cpos = pos; /* Offsetposition des letzten Zeichens 
/* innerhalb der Datei merken 
register unsigned int i, J; /* Schleifenzähler 
StoreFormat( &fpropc, 8, pos ); /* Zeichen-Format merken unsigned int datnan; /* Anzahl der Dateinamen 
BYTE errcode = ß; /* Fehlercode 


/*-- Rest der Page mit Nullen füllen if (arge<2) /* zu wenige Argumente? 
errcode = 1; /* keine Dateiname angegeben 


for (1 = 8, j = PAGELEN - (pos % PAGELEN); i < j; i++) ar 


WriteChar( NULL ); 
datnan = ß; /* noch keinen Dateinamen entdeckt 
WriteCharFormat(); /* Zeichenformate schreiben for (++argv, i=1; iKarge; ++i, ++argv) 
apos = POS; /* Position der Absatz-Formate merken { /* die Argumente durchlaufen 
riteParaFormat( cpos ); /* Absatz-Formate ausgeben .: ( Wtargv == '/' ) /* Komman es 
* Ja 
WriteVorspann( cpos, papos ); /* Vorspann ausgeben strupr( nr )% /* Umwandlung in Großbuchstaben 
close( handle ); /* Ausgabe-Datei schließen for (j=8; j<ELVEK(kzps); ++j) /* Paramter überprüfen 
printf(”\n”); /* in die nächste Zeile schalten { 
return TRUE; /* alles o.k. if ( stremp(kzps[j).shortcut, *argv+1) == 8 | 
} SU ENBIKDaL I -beta. *%argv+i) == 8) 
break; * Parameter erkannt, Schleife beenden 
[ PB EN ENENN NNNERNE if ( 3 == ELVEK( kzps ) ) /%* Parameter erkannt? 
/* Nein 
errcode = 2; /* ungültiger Parameter 
gal : Die a er Dateien konvertieren break; /* aus der Schleife ausbrechen 
Eingabe-Parameter: ARGC = Anzahl der Argumente } 
ARGV = Pointer auf den Vektor mit den else /* der Parameter wurde erkannt 
Pointern auf die einzelnen Args *kzps[j].flag = kzps[j].vert; /* Flag setzen 
Return-Wert : TRUE, wenn die Dateien konvertiert } 
werden konnten, sonst FALSE else /* kein Kommandozeilen-Parameter 
Ba la a a 2 2 2 2 E82 2 2 2.202 2.2.2 02.2.2 2.2.2 0202 00.2.2122 .2 020202 .2.2 12.202702 72.2 0202 702.2.2.2.2.2.2.2.2.202.2.2.2.2.3 ++datnan; /* nuß ein Dateiname sein 


} 
BYTE Convert( unsigned int arge, char **argv ) if ( datnam == 8 ) /* keine Dateinamen gefunden? 
{ errcode = 1; /* Nein 


register unsigned int i; /* Schleifenzähler 
char dateiname[66]; /* Name der zu berabeitenden Datei 
char *ppos; /* Ptr auf den Punkt im Dateinamen 


IT — — 
for (++argv, i=1; iKarge; +1, +ar x 


ng 0); 
/% die Argumente durchlaufen printf(”] BW 2.180: BLD-Dateien in Word-Datei” 
if ( argv != '/' ) /* Kommandozeilen-Parameter? ”en umwandeln. |\n”); 
{ /* Nein, nuß Dateiname sein printf("”] Erliegen des Hardcopy: %s In”, 
strepy( dateiname, *argv ); /* Dateiname kopieren ( rahmen ) ? "Ja ” : "Nein” ); 
if ( strrehr( dateinane, '.' ) == NULL ) printf(”] Ausgabe für DocuJet : %s In”, 
strcat( dateiname, BILD FILE ); /* Erw. anhängen ( docujet ) ? "Ja ” : "Nein” ); 
if ( ProcessFile( dateinane ) == 6) /* Datei konvert. printf("] (C) 1986-89 G.Jürgensmeier, M.Tischer.” 
return FALSE; /* Fehler “ \n"); 
} Pest j 
} "Alle Rechte vorbehalten. |[\n"); 
ae TRUE; /* alle Dateien einwandfrei konvertiert */ printf(” r 
m — — — — sn"); 
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if ( errcode == 1 ) /* keine Dateinamen gefunden? %*/ [PR ae EEE EEE NEE 
{ 


/# Ja %/ 
printf("Achtung! Keine Dateinamen angegeben.\n”); HAUPTPROGRAMM 


return FALSE; /* mit Fehlercode zurück */ 
RM AR HR BED EB / 


else 
if ( errcode == 2 ) /* ungültiger Parameter? */ 
16 /* Ja */ 
printf("Achtung! Parameter nicht erkannt \"%s\”.\n”,*argv); 


void main( unsigned int argc, char *argv[] ) 


if ( ProcessArgs( argc, argv ) ) /* Argumente auswerten */ 


return FALSE; /* mit Fehlercode zurück */ 
if ( rahmen = 1 ) /* einfacher Rahmen? */ if ( Convert( argc, argv ) ) /* Dateien konvertieren */ 
rptr = &einfach; /* Ja, Pointer auf Rahmenzeichen merken */ 
else /* kein einfacher Rahmen */ 
if ( rahnen == 2) /* doppelter Rahmen? */ 
rptr = &doppelt; /* Ja, Pointer auf Rahmenzeichen merken */ 
at TRUE; /* alles o.k. %/ 


exit( 8); /* alles o.k. %/ 
exit( 1); /* Programm mit Fehlercode verlassen */ 


} 
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EIHIP WISSEN 


Hans-Joachim Sacht: 


Programmieren mit QuickBASIC 
4.0 und 4.5 


Das Buch bietet die vielfältigen Funktio- 


210 Seiten, 66 Bilder, Harteinband nen in konzentrierter Form und geht vor 
mit 5,25-Zoll-Diskette allem auf die Handhabung und Sbrachels. 
48,— DM/ISBN 3-8023-0245-1 mente dieses Compilers ein. Programmie- 
Durch die neuen Microsoft-Compiler rern, die bisher nur mit einem BASIC- 
QuickBASIC 4.0 und 4.5 können so kom- Interpreter gearbeitet haben, wird erklärt, 
fortable und gutstrukturierte Programme wie sie schnell auf QuickBASIC umsteigen 
entwickelt werden, wie es sonst nur mit und so die Vorteile der Kompilierung aus- 
einem leistungsfähigen Interpreter nutzen können. Eine Diskette mit den im 
möglich war. Buch behandelten Beispielen liegt bei. 


Hans-Joachim Sacht: 


Vom Problem zum Programm 


ET At Turbo 1. Teil erklärt Grundlagen der BASIC- 

ä r Programmierung unter Einbezie- 
464 Seiten, 183 Bilder hung der wichtigsten MS-DOS- 
4., völlig überarbeitete Auflage 1988 Kommandos, Compiler 
48, DM/ISEN 3-8023-0214-1 2. Teil brin t zahlreiche Pro ti 
Das von Microsoft entwickelte GW-BASIC nen für breite ne 
bzw. BASICA gilt inzwischen bei 16-bit- RR WR BET 
Computern als Standard und für 32-bit- 3. Teil zeigt, wie ein Programm Schritt für 
Rechner als Grundlage des Sprachum- Schritt entsteht. 
fangs auch anderer neuer Dialekte. Eine Diskette mit den im Buch behandel- 


Die Neukonzeption gliedert sich in 3 Teile: ten Beispielen ist erhältlich. 


Fe ee in & VOGEL Buchverlag Würzburg 
Bestellen Sie gleich! Postfach 6740 - 8700 Würzburg | 
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SAA-Benutzeroberfläche in C 


Teil 2): 


Eine komfortable Benutzeroberfläche in 


Zugriff auf Tastatur und Maus 


Nachdem sich der erste Teil dieser Serie mit 
dem Zugriff auf den Bildschirm beschäftigt hat, 
ist diese Folge den Eingabegeräten Tastatur und 
Maus gewidmet. Wiederum möchten wir Ihnen 
eine Reihe von C-Funktionen vorstellen, die 
Ihnen bei der Erstellung SAA- bzw. DOS 4.0- 
konsistenter Benutzeroberflächen wertvolle 
Dienste leisten. 


Windows und MS-DOS 4.0 haben vorgemacht, was schon 
bald nicht mehr nur als interessantes Feature begrüßt, son- 
dern als fester Bestandteil eines Programms erwartet wer- 
den wird: die Unterstützung der Maus als vollwertiges Ein- 
gabegerät. Nicht eine einfache Tastatur-Emulation, wie 
etwa die Umsetzung der Mausbewegung in die Betätigung 
der entsprechenden Cursortaste, sondern die Beachtung der 
individuellen Philosophie, die diesem Eingabegerät zugrun- 
de liegt, ist hier gefordert. 


Unterschiede zwischen Tastatur und Maus 


Bevor man sich an die Entwicklung eines Maus-Interfaces 
macht, sollte man sich den grundlegenden Unterschied zwi- 
schen den Eingabegeräten Maus und Tastatur vor Augen 
führen. Zwar stellen beide ein Medium dar, mit dessen 
Hilfe der Anwender Informationen an ein Programm über- 
mitteln kann, doch tragen diese Informationen unterschied- 
lichen Charakter. Im Fall der Tastatur ist die übermittelte 
Information der Code einer betätigten Taste, der vom Pro- 
gramm im Rahmen des aktuellen Kontexts interpretiert 
wird und zu dessen Verarbeitung es keiner weiteren Infor- 
mation bedarf. Anders verhält es sich jedoch mit der Maus. 
Eine Information, wie z.B. die Nachricht, daß der linke oder 
rechte Mausknopf niedergedrückt wurde, ist zunächst ein- 
mal sinnleer und erhält erst durch die Kombination mit 
einer anderen Information Gewicht. Indem nämlich die 
Bildschirmposition und damit das Objekt, über dem sich 
der Maus-Cursor befindet, in Bezug zu der Maus-Infor- 
mation gesetzt wird, erfährt das Programm, was ihm der 
Anwender mitteilen möchte. 

Wie man diese Philosophie nutzen kann, um einen 
Großteil der Programmfunktionen, die nicht mit der Ein- 
gabe alphanumerischer Informationen zusammenhängen, 
über die Maus abwickeln zu können, machen grafische 
Benutzeroberflächen wie etwa MS-Windows vor. Sie stellen 
auf dem Bildschirm zahlreiche Symbole (Icons) dar, die 
jeweils mit einer bestimmten Programmfunktion verbunden 
sind und vom Anwender mit Hilfe des Mauszeigers erreicht 
und aktiviert werden können. 

Zwar können textorientierte Applikationen - und um die 
geht es in dieser Serie - von dieser Möglichkeit nicht in dem 
Umfang Gebrauch machen, wie es im Grafikmodus möglich 
ist, doch bestimmt auch hier die jeweilige Mausposition, wie 
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Include-Datei 
: zur Einbindung der Funktionen 
zum Zugriff auf Tastatur & Maus 
: 25.81.1989 
30.81.1989 


: 1989 by MICHAEL TISCHER 


erstellt am e 
letztes Update am: 


(Copyright) 


/*-- Typedefs 
#ifndef BYTE 
typedef unsigned char BYTE; 
Zendif 
typedef void (* FKTPTR)( void ); 


typedef unsigned int TASTE; 


/* BYTE bereits definiert? 
/* Nein, definieren 


/* Ptr auf VOID-Funktion 
/* Tastencode 


typedef unsigned long PTRVIEN; /* Maske für Maus-Cursor 
typedef struct { 
BYTE x1, 
yI, 
“2, 
y2; 
E er 
} BEREICH; 


/* Koordinaten der oberen linken 
/* und unteren rechten Ecke des 
/* spezifizierten Bereichs 


/* Maske für Maus-Cursor 


/#-- Konstanten 
Fifndef TRUE /"* TRUE und FALSE bereits definiert? 
define TRUE 1 
#define FALSE 8 
Zendif 


/#=- Event-Codes 


EV_MOU_MOVE 1 /" Maus bewegt 
EV LEFT PRESS 2 /#* linker Mausknopf niedergedr. 
EV_LEFT REL 4 /* linker Mausknopf losgelassen 
EV RIGHT_PRESS 8 /* rechter Mausknopf niedergedr. 
EV RIGHT REL 16 /* rechter Mausknopf losgelassen 
EV_MOU_ALL /* alle Maus-Events 
#define EV_KEY_ AVAIL 32 /* Taste verfügbar 
#define KEIN BEREICH 255 /* Maus-Cursor nicht in Bereich xy 
/#-- Codes einiger Tasten, wie sie KbdGetKey() liefert 
#define BEL Klingelzeichen 
Backspace-Taste 
Tabulator-Taste 
Linefeed 
Return-Taste 
Escape-Taste 
Leer-Taste 
CIRL+A 


ww 
Pr 
++ 
aw 


RS SE Ta Ka: Sa Di 


Be Da Den De De DE DE RED Fe DER DE Fa Da. DER 


EEEEEEFEERLEEEE 
SEEEEEFEEFEEREE 


++ t++++++ +++ ++ 


Listing 1: KBM.H 


* 
“ 


”/ 


SAA-Benutzeroberfläche in C 


: 


#define ALT_F3 
#define ALT_F4 


<' ei -' u ='o 


= 


EEEEEFEEEE 


++++++ +++ + 


NIE XE<c4J3noO 


#define BACKTAB 
#define ALT_Q 
#define ALT_W 
#define ALT_E 
#define ALT_R 
define ALT_T 
#define ALT_Y 
#define ALT_U 
#define ALT_I 


#define ALT A 
define ALT_S 
define ALT D 
define ALT_F 


#define CTRL_PGUP 
/%#-- Makros 


MouGetCol() (ev_col) /* liefern Mausposition & */ 

MouGetRow() (ev_row) /* -bereich im Moment des */ 

MouGetBereich() (ev ber) /* Event-Eintritts */ 

IsAKey(k) ((k) < 256 ) /* ist K Ascii-Taste? */ 

IsXKey(k) ((k) >= 256) /* ist K erweiterter T.Code? */ 

MouAvail() ( mavail ) /* liefert TRUE, wenn Maus v. %/ 

/* Taste verfügbar? */ 

/* Typumwandlung für CHAR %*/ 

#define MouGetAktCol() ( moucol ) /* liefern jeweils aktu- */ 

#define MouGetAktRow() ( mourow ) /* elle Mausposition */ 
#define MouGetAktBer() ( mouber ) 


» 
rm 
u | 
zZ 


Fi-Taste 
F2-Taste 
F3-Taste 
F4-Taste 
F5-Taste 
F6-Taste 
F?-Taste 
F8-Taste 
F9-Taste 
Fiß-Taste 
Cursor-Down 
Cursor-Hone 
Cursor-Up 
Cursor-Page Up 
Cursor-Le 
Cursor-Right 
Cursor-Right 
Cursor-Page Dn 
DELETE-Taste 
SHIFT + Fi 
SHIFT + F2 
SHIFT + F3 
SHIFT + F4 
SHIFT + F5 
SHIFT + F6 
SHIFT + F7 
SHIFT + F8 
SHIFT + F9 
SHIFT + F18 
CTRL + Fi 
CTRL + F2 
CIRL + F3 
CTRL + F4 
CIRL + F5 
CTRL + F6 
CIRL + F? 
CTRL + F8 
CTRL + F9 
CTRL + FiB 
J ALT + Fi 
#define ALT_F2 ALT + F2 


/#-- ist Taste X mit einer Funktion verknüpft? 
#define IsFkt(x)\ 
("fkttab + ((X) $ Z)) K(1 Ki) &7))) 


/#-- ist Taste X ein Makro? 
#define IsMakro(x)\ 
(*(makrotab + ((x) > 3)) & (1 << ((x) & 7))) 


/#-- Liefert die Anzahl Elemente in einem Vektor X 
#define ELVEK(x) ( sizeof(x) / sizeof(x[8]) ) 


/#-- Makros zur Erstellung der Bit-Maske, die das Er- ----*/ 
/#-- scheinungsbild des Software-Maus-Cursors definiert ----*/ 


\ 


define MouPtrMask( ) 
°< 24) +\ 
< 


2, 

( (t (PTRVIEN) f) > 
((( PTRVIEN) 2) > < 16) +\ 
(((f) & 255) << 8) + ((z) & 255) ) 


define PTRSAMECHAR ( BxBBff ) 
#define PTRDIFCHAR(z) ( (z) << 8) 


define PTRSAMECOL ( Bxddtf ) 

( 8x7777 ) 

( Bx807f ) 

( BxF777 ) 
define PTRDIFCOL(f) ( (f) «8 ) 
#define PTRDIFCOLB(f) ( ((f)IExBB) << 8 ) 


/%#-- Funktionsdeklarationen über Makros 


#define MouSetMoveAreaAll()\ 
MouSetMoveArea( 8, 8, tcol-1, tline-1 ); 


#define KbdUngetKey(x) KbdINextKey(x) 


f 
8 
8 
+ 


/*-- externe Variablen 


extern BYTE * fkttab, 
* makrotab, 


Listing 1: (Fortsetzung) Listing 1: (Fortsetzung) 
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extern int 


BYTE KbnInit 

void KbmEnd 

int KbmEventhait 
void MouSetBereich 
void MouShowMouse 
void MouHideMouse 
void MouSetMoveArea 
void MouSetSpeed 
void MouDefinePtr 
void MouSetDefaultPtr 
void MouSetPtr int col, int row ); 
void MouPushPara void ); 


( void ); 
( 
( 
( 
( 
( 
( 
( 
( 
( 
\ 
void MouPopPara ( vold ); 
( 
( 
( 
( 
( 
( 
( 
( 
( 
( 
( 


void ); 

int wait_event ); 

BYTE anzahl, BEREICH * ptr ); 

void ); 

void ); 

BYTE x1, BYTE y1, BYTE x2, BYTE y2 ); 
int Me int yspeed ); 

PTRVIEN mask ); 

PTRVIEN standard ); 


TASTE KbdGetKey void ); 
void KbdFlushBuf void ); 
void KbdClearAllMaks void ); 
void KbdClearAllFkt void ); 
TASTE key, TASTE *ptr, BYTE anzahl ); 
TASTE key ); 
TASTE key, FKTPTR fktptr ); 
TASTE key ); 


TASTE * lbptr, int len ); 
void ); 
TASTE key ); 


int KbdStopLearn 
void KbdINextKey 


Listing 1: (Ende) 


das Programm beispielsweise auf die Betätigung eines 
Mausknopfs zu reagieren hat. Darum muß ein Maus-Inter- 
face über die Möglichkeit verfügen, den Bildschirm in ver- 
schiedene Bereiche (Objekte) zu unterteilen, um einem 
übergeordneten Modul bei der Betätigung eines Maus- 
knopfs mitteilen zu können, welches Objekt der Anwender 
ausgewählt hat. Dies aber wirft die Frage auf, wie ein Maus- 
Interface von der Betätigung eines Mausknopfes Notiz 
nehmen und die aktuelle Mausposition ermitteln kann. 


Kommunikation zwischen 
Maus-Interface und Maus-Hardware 


Als Mittler zwischen einem Programm und der Maus-Hard- 
ware fungiert ein Maustreiber, der entweder beim Booten 
des Systems als Gerätetreiber installiert, oder als 
eigenständiges (TSR-) Programm von DOS aus gestartet 
werden kann. Er überwacht ständig die Bewegungen der 
Maus sowie den Status der Mausknöpfe und bewegt den 
Maus-Cursor parallel zur Maus über den Bildschirm. Da 
dieser Treiber direkt auf die Hardware der Maus eingehen 
muß und sich die Mäuse der verschiedenen Hersteller zum 
Teil stark unterscheiden, ist ein solcher Treiber in der 
Regel im Lieferumfang einer Maus enthalten. 
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Aufgabe 


Reset des Maustreibers 

Maus-Cursor auf dem Bildschirm anzeigen 

Maus-Cursor vom Bildschirm entfernen 

a 6.0 und Status der Mausknöpfe ermitteln 
Position des Maus-Cursors festlegen 

Information über Betätigung der Mausknöpfe ermitteln 
Information über Loslassen der Mausknöpfe ermitteln 
horizontale Bewegungsgrenzen für Maus-Cursor festlegen 
vertikale be für Maus-Cursor festlegen 
Erscheinungsbild des Maus-Cursors im Grafikn. definieren 
Erscheinungsbild des Maus-Cursors im Textmodus festlegen 
relative EEE ermitteln 

benutzerdefinierten Event-Handler installieren 
Emulation des Lichtgriffels anschalten 

Emulation des Lichtgriffels ausschalten 

a mh festlegen 

Bereich festlegen, in dem der Maus-Cursor nicht erscheint 
nicht definier 

nicht definiert 

Faktor für Verdoppelung der Maus-Geschwindigkeit setzen 
benutzerdefinierte Event-Handler austauschen 

Größe des Maus-Status-Puffers ermitteln 

Maus-Status in einem Puffer des Aufrufers sichern 
Maus-Status aus einem Puffer des Aufrufers restaurieren 
weitere Event-Handler installieren 

Adresse eines bestimmten Event-Handlers ermitteln 
Maus-Geschwindigkeit und Faktor für Verdoppelung festlegen 
aktuelle Maus-Geschwindigkeit ermitteln 

Interrupt-Rate des Maustreibers festlegen 
Bildschirmseite für Maus-Cursor definieren 
Bildschirmseite des Maus-Cursors ermitteln 

Maustreiber deaktivieren 

Maustreiber aktivieren 

Reset des Maustreibers ohne Hardware-Initialisierung 
Fremdsprache für Treiber-Meldungen festlegen 
Fremdsprache für Treiber-Meldungen ermitteln 

Information über Maus-Hardware und -Treiber ermitteln 


Tabelle 1: Die Funktionen des Maustreibers 


Trotz der unübersehbaren Unterschiede im Hinblick auf 
die Maus-Hardware, unterstützen die Maustreiber fast aller 
Maus-Hersteller ein Software-Interface, das dem der 
Microsoft-Maus zumindest im Hinblick auf die unterstütz- 
ten Funktionen und deren Aufruf nachempfunden ist. Als 
Schnittstelle zwischen einem Programm und dem Maustrei- 
ber dient dabei der Interrupt 33h, über den die verschie- 
denen Funktionen des Maustreibers aufgerufen werden 
können. 

Wie beim Software-Interface des DOS-Kerns (Interrupt 
21h) erfolgt der Informationsaustausch dabei mit Hilfe der 
verschiedenen Prozessorregister. Dadurch ist es auch einem 
C-Programm möglich, die einzelnen Maus-Funktionen mit 
den Bibliotheksfunktionen int86 und int86x aufzurufen. 

Wie Tabelle 1 zeigt, stellt der Maustreiber einem Pro- 
gramm eine Reihe verschiedenster Funktionen zur Verfü- 
gung, von denen jedoch nur einige wenige in jedem Fall 
benötigt werden. Auch kann man nicht davom ausgehen, daß 
alle der oben genannten Funktionen von jedem Maustreiber 
unterstützt werden, da die hier vorgestellten Funktionen 
komplett erst ab der Version 6 des Microsoft-Maustreibers 
verfügbar sind. Aus diesem Grund beschränkt sich das hier 
vorgestellte Modul auf die Arbeit mit den Funktionen 00h 
bis OFh, die auch von älteren Versionen des Maustreibers 
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Bild 1: Die Markierung eines Bereichs mit der Maus in 
KBMDEMO. 


unterstützt werden. Falls Sie an den Aufrufkonventionen 
der einzelnen Funktionen interessiert sind, schlagen Sie 
bitte in dem Listing auf den folgenden Seiten nach, in dem 
diese Aufrufe jeweils ausführlich dokumentiert werden. 


Das C-Modul KBM.C 


Alle Funktionen zur Abfrage der Maus und Tastatur, die im 
Rahmen dieses Artikels vorgestellt werden, finden sich in 
dem C-Modul KBM.C, das auf den vorhergehenden und 
folgenden Seiten abgedruckt ist (Listings 1 und 2). KBM steht 
dabei für Keyboard & Mouse und stellt gleichzeitig das 
Präfix dar, das allen Funktionen innerhalb des Moduls vor- 
ausgeht, die sich auf das Modul als Ganzes bzw. sowohl auf 
die Tastatur als auch auf die Maus beziehen, wie etwa 
KbmInit( ) zur Initialisierung des Moduls. 

Aus der Sicht eines übergeordneten Moduls stehen die 
Funktionen KbmEventWait() und GetKey( ) im Mittel- 
punkt des KBM-Moduls. Erstere dient dabei zum Warten auf 
ein bestimmtes Ereignis; auf ein Event, wie man im Engli- 
schen sagt. Dieses Ereignis kann entweder die Betätigung 
einer Taste oder ein Ereignis im Zusammenhang mit der 
Maus sein, wobei folgende Ereignisse erfaßt werden kön- 
nen: 


= die Bewegung der Maus 
= die Betätigung des linken oder rechten Mausknopfes 
= das Loslassen des linken oder rechten Mausknopfes 


Beim Aufruf von KbmEventWait( ) wird das zu erwar- 
tende Ereignis in Form einer Bitmaske angegeben, die Sie 
durch Oder-Verknüpfung der verschiedenen Ereignis-Kon- 
stanten aus der Include-Datei KBM.H erstellen können. Der 
Aufruf 
KbmEventWait( EV_KEY_AVAIL !| EV_LEFT_PRESS) 
würde KbmEventWait( ) z.B. dazu veranlassen, auf die 
Betätigung einer Taste oder die Betätigung des linken 
Mausknopfs zu warten. Erst wenn eines dieser Ereignisse 
eingetreten ist, kehrt die Funktion zum Aufrufer zurück, 
wobei sie eine Bitmaske übergibt, aus der der Aufrufer die 
Art des bzw. der eingetretenen Ereignisse ermitteln kann. 


Bild 2: Es können Bildschirmbereiche definiert werden, in 
denen sich der Maus-Cursor automatisch verändert. 


Die Art, wie KomEventWait() auf den Eintritt des 


bzw. der Ereignisse wartet, unterscheidet sich etwas von der 
Art und Weise, wie man derartige Aufgabenstellungen sonst 
zu lösen pflegt. Normalerweise würde man die Geräte Maus 
und Tastatur in einer Schleife so lange direkt abfragen, bis 
eine der dazu aufgerufenen Funktionen anzeigt, daß das 
erwartete Ereignis eingetreten ist. Diese Vorgehensweise 
(man bezeichnet sie als Polling) bringt aber nicht nur bei 
ihrer Realisation in Hochsprachen den Nachteil mit sich, 
daß die Abfrageschleife unter Umständen zu langsam ist, 
um unmittelbar auf das Ereignis reagieren zu können - daß 
beispielsweise zwar die Betätigung des Mausknopfes 
bemerkt wird, die Maus sich zu diesem Zeitpunkt aber 


9 0 RN EEE NENNE / 


: Stellt verschiedene Funktionen zur 
Abfrage von Maus und Tastatur be- 


: MICHAEL TISCHER 
entwickelt am : 25.81.1989 
letztes Update : 2.82.1989 


» CL /ALSIMICHLIH] KBM.C /C 
dann mit einem anderen Modul linken 


/*-- Include-Dateien einbinden 


include "vio.h” 
include "kbm.h” 
#include <dos.h> 
include <bios.h> 
include <stdlib.h> 
#include <menory.h> 


/* Zugriff auf die Video-Funktionen */ 
/* eigene Include-Datei einbinden */ 


/#-- Typedefs 


/* WORD bereits definiert? */ 
/* Nein, definieren %/ 


#ifndef WORD 

typedef unsigned int WORD; 
Zendif 
typedef void (interrupt far *INTHANDLER)(); 


typedef void (_saveregs _loadds far * MOUHAPTR)( void ); 


Listing 2: KBM.C 
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typedef struct /* nimmt aktuelle Mausparameter auf BYTE key avail = FALSE, /%* ist TRUE, wenn Taste verfügbar 

ei: ctrI_break = FALSE; /* ist TRUE, wenn CGtrl-Break gedr. 

BYTE anz_bereich; /* Anzahl der Bereiche TASTE key buf[ KB_LEN ]; /* interner Tastaturpuffer 
BEREICH * akt_bereich; /* Pointer auf Bereichs-Vektor TASTE * kbstart = key_buf, /* Pointer auf nächstes und 

PTRVIEN stdptr; /* aktueller Standard-Maus-Cursor * kbend = key_buf; /* letztes Zeichen im KEY_BUF 

/* Eck-Koordinaten der aktuellen 

/* Maus-Area BYTE makroanz = 9, /* noch kein Makro definiert 

fktanz = 9, /* noch keine Funktion definiert 

*makrotab, /* Pointer auf Bit-Tabelle für Makros 

*fkttab; /* Pointer auf Bit-Tabelle für Funktionen 


typedef struct /#* beschreibt einen Tasten-Funktionsaufruf KEY_FKT *fktvec; /* Ptr auf Vektor mit Fkt.-Beschreibern 
KEY_MAK *makvec; /* Ptr auf Vektor mit Makro-Beschreibern 

TASTE key; /* die jeweilige Taste 
FKTPTR fkt; /* Pointer auf auzurufende Funktion TASTE * lernbuf, /* Pointer auf Lern-Puffer 
} KEY_FKT; * lbakt; /* Pointer auf aktuelle Position 
int lblen; /* Länge des Lernbuf in TASTEn ” 
bug struct /* beschreibt ein Tastaturmakro BYTE lern = FALSE; /* Lern-Modus aus 


/* die umzusetzende Taste /#*-- Variablen, die mit jedem Aufruf des Maus-Handlers 
anzahl ; /* Anzahl der erzeugten Tasten /*-- geladen werden 
TASTE *bufptr; /* Pointer auf Vektor mit Makro-Tasten 
} KEY_MAK; mouber = KEIN BEREICH, /* aktueller Maus-Bereich 
moucol, /* Mausspalte (Text-Bildschirn) 
/#-- Konstanten nourov; /* Mauszeile (Text-Bildschirm) 
mouevent; /* Event-Maske 
#define MAX_STACK 28 /* Größe des Parameter-Stack 
#define KB LEN 188 /* Länge des Tastatur-Puffers Variablen, die nur bei Eintritt eines erwarteten 
#define KB_INTR 8x89 /* Tastatur-Interrupt Events durch den Maus-Handler geladen werden 
#define CTRLB_INT £x1b /* Gtrl-Break-Interrupt 
#define CTRLC INT 8x23 /* Gtrl-C-Interrupt ev_ber, /* Bereich, in dem sich die Maus befindet 
#define KB_INTR 12x89 /* Tastatur-Interrupt ev_col, /* Mausspalte 
ev_rTov; /* Mauszeile */ 


#define KEY_EXPANDED ( 32768 ) /* Taste bereits expandiert 
[Pa ae EBEN BEDIENEN EEE NEE NED NED RAR AREA NEE 


/%*-- Makros :KbdHandler 
*% 


define MOUINT(rin, rout) int86(8x33, &rin, &rout) 
define MOUINTX(rin, rout, sr) int86x(2x33, &rin, &rout, &sr) 


#define KbEmpty() ( kbend == kbstart ) 


Aufgabe : Dies ist der neue Tastatur-Handler, 
der bei jeder LENE einer Taste 
in Form des Interrupts 8x9 durch die 
PC-Hardware aufgerufen wird. 


Return-kert : keiner 
Info : - Diese Funktion ist nur zum Aufruf 


/*-- Makros zur Umrechnung zwischen Maus-Koordinaten in ----*/ 
durch die PC-Hardware bestimmt und 


I Eger Ad den virtuellen Maus-Bildschirm und dem ----*#/ 
darf nicht von einer anderen Fkt. 


/%-- Textbildschirn u / 
aus aufgerufen werden. * 
define XTOCOL(x) >> xshift) /* X durch 2°xshift */ EEE NEBEN IE BEHEBEBRENEEBINEEEEENE ENENENE 


#define YTOROK(y) y»3) /%* Zeile durch 8 */ 
#define COLTOX(c) c) << xshift ) /* C mal 2"xshift #*/ #pragma check_stack(off) /* kein Stack-Checking hier */ 


#define ROWTOY(r) << 3) /* Zeile mal 8 */ 
void interrupt far KbdHandler(es, ds, di, si, bp, sp, dx, 
cx, ax, ip, cs, flags ) 


* 

* 

* 

* 

* Eingabe-Parameter: keine 
* . 

* 

* 

* 


ze x* 


/*-- globale Variablen 


int tline, /* Anzahl Text-Zeilen 
/* Anzahl Text-Spalten (*OldKbHandler)(); /* alten Interrupt-Handler aufrufen */ 


/* Koordinaten der aktuellen Maus-Area if ( ctrl_break ) /* wurde Ctrl-Break betätigt? */ 
/* (Bildschirmbereich, in dem sich die { /* Ja %*/ 
/* Maus bewegen darf) ctrl_break = FALSE; /* Flag zurücksetzen */ 

ER _KEYBRD_READ ); /* Break-Code holen */ 


2 es, ds, di, si, bp, sp, dx, cx, ax, ip, cs, flags; 


‘ if ( key_avail == FALSE ) /* keine Taste verfügbar? */ 
/*-- Maske für den Standard-Maus-Cursor key avail = ( _bios_keybrd( _KEYBRD_READY ) != 8 ); 
PTRVIEN stdptr = MouPtrMask( PTRSAMECHAR, PTRINVCOL ); } 


BYTE * bpuf, /* Ptr auf Puffer für Bereichs-Erkennun Spragma check stack /* alten Zustand im Hinblick auf das */ 
anz_bereich = ; /* bisher keine Bereiche definier Jpragma check stack /* Stack-Checking wieder herstellen */ 

BEREICH * akt_bereich; /* Pointer auf akt. Bereichs-Vektor 
[#0 BER BANKEN HERNE EIER 


MOUPARA moustack[ MAX_STACK ]; /* Parameter-Stack * Funktion :MouHandler 
MOUPARA * stackptr = moustack; /* Stackpointer für P-Stack 
: Dies ist der Maus-Handler, der durch 


INTHANDLER OldKbHandler, /* Ptr. auf alten Tast-Int-Handler * den installierten Maustreiber bei 
OldCtrlCHandler, /* alter Ctrl-C-Handler Eintritt eines bestimaten Ereignisses 
OldCtr1BHandler; /* alter Ctrl-Break-Handler aufgerufen wird. 


“= xx 


Listing 2: (Fortsetzung) Listing 2: (Fortsetzung) 
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* 


Eingabe-Parameter: AX-Register = Event-Maske 

BX-Register = Status der Maus-Knöpfe 

CX-Register = Maus-Spalte im virt. B. 

DX-Register = Maus-Zeile im virt. B. 

SI-Register = vertikale Mausbewegung 

DI-Register = horizontale Mausbewegung 

Return-kert : keiner 

Info : = Diese Funktion ist nur zum Aufruf 
durch den Maustreiber bestimmt und 
darf nicht von einer anderen Fkt. 
aus aufgerufen werden. 

- Die Funktion muß über genau eine 
lokale Variable verfügen, die auf 
dem Stack ein WORD beansprucht. An- 
derenfalls müssen die Konstanten 
zum Zugriff auf die Register ver- 


ändert werden. 
EHER BR EHE EB EEE EEE EEE DD N NE BE / 


KEKEKKKKEKKKK RK CK 
zEKKEKKKEK € 


#pragma check_stack(off) /%* kein Stack-Checking hier */ 
#define REG(x) (*((unsigned *) &dummy+x)) 

/define AX REG(18) /* Konstanten zum Zugriff auf die Pro- */ 
#define BX REG(7) /%* zessorregister, die durch das Attri- */ 
define CX REG(9) /%* but SAVEREGS nach dem Aufruf der “/ 
#define DX REG(8) /* Funktion auf dem Stack gesichert %/ 
#define SI REG(4) /#* werden ”/ 
#define DI REG(3) 


void _saveregs _loadds far MouHandler( void ) 
/* darf nicht entfernt werdent (s.o.) %/ 
mouevent = AX; /* Event-Maske nerken */ 


moucol = XTOCOL( CX ); /* Spalte in Textspalten umrechnen */ 
mourow = YTOROW( DX ); /* Zeile in Textzeilen umrechnen */ 


unsigned dummy; 


/*-- Bereich ermitteln, in dem sich die Maus befindet und -*/ 
/%*-- feststellen, ob sich der Bereich seit dem letzten -r/ 
/*-- Aufruf des Handlers verändert hat. In diesem Fall -r/ 
/#*-- wird eine neue Maske für das Erscheinungsbild des -#/ 
/*-- Maus-Cursors gesetzt. I 4 
dummy = *(bpuf + mourow * tcol + moucol); /* Ber. holen %*/ 
if ( dummy ?!= mouber ) /* neuer Bereich? */ 
MouDefinePtr( (dummy == KEIN BEREICH) ? /" Ja %*/ 

stdptr : (akt_bereich+dummy)->ptr_mask ); 
mouber = dummy; /* Bereichsnummer in globaler Var. merken */ 


/* alten Zustand im Hinblick auf das */ 


#pragma check _stack 
/* Stack-Checking wieder herstellen */ 


#pragma check_stack 


[ PaRORHaNE NE 
:BreakHandler 


: Wird bei Betätigung von Ctrl-Break 
und Ctrl-C aufgerufen. 
Eingabe-Parameter: keine 
Return-kert : keiner 
Info : - Kehrt unmittelbar zum Aufrufer zu- 
rück und verhindert dadurch die 
Programmbeendigung. 
REN BIENEN DENE NE NE EEE NR REN NENNEN NENNEN NEE IDEE DEREN IE / 


#pragma check _stack(off) 


/* kein Stack-Checking hier */ 


void interrupt far BreakHandler(es, ds, di, si, bp, sp, dx, 
cx, ax, ip, cs, flags ) 


WORD es, ds, di, si, bp, sp, dx, cx, ax, ip, cs, flags; 


{ 
eek = TRUE; /* Ctrl-Break wurde betätigt */ 


/* alten Zustand im Hinblick auf das */ 


/pragma check_stack 
/* Stack-Checking wieder herstellen */ 


#pragma check _stack 


Listing 2: (Fortsetzung) 


bereits wieder an einer anderen Bildschirmposition befindet 
und dadurch auf ein falsches Bildschirmobjekt Bezug 
genommen wird. Ein anderer Nachteil des Pollings macht 
sich vor allem in Multitasking-Umgebungen wie z.B. MS- 
OS/2 sehr unangenehm bemerkbar: die CPU wird fortwäh- 
rend mit der Ausführung der Abfrageschleife beschäftigt, 
ohne dabei produktiv zu sein und ihre Arbeitskraft anderen 
Prozessen zuwenden zu können. 

Aus diesem Grund wendet bereits das ROM-BIOS des 
PC, aber auch der Gerätetreiber der Maus, zur Abfrage des 
jeweiligen Geräts eine andere Technik an. Indem die 
Geräte nicht permanent abgefragt, sondern die entspre- 
chende Abfrageroutine von dem Gerät selbst über einen 
Interrupt immer nur dann aufgerufen wird, wenn ein Ereig- 
nis eingetreten ist, wird nicht unnötig Prozessorzeit ver- 
schwendet, das Ereignis aber trotzdem unmittelbar nach 
seinem Eintritt erkannt. 

Nicht anders geht das KBM-Modul vor, indem es einen 
eigenen Interrupt-Handler für die Tastatur und die Maus 
installiert. Der Tastatur-Handler mit dem Namen Kbd- 
Handler( ) wird dabei in die Kette der Interrupt-Handler 
des Interrupt 09h eingeklingt, der von der Tastatur immer 
dann aufgerufen wird, wenn ein Taste niedergedrückt oder 
losgelassen wird. Wie in der letzten Folge des Microsoft 
System Journals in dem Artikel »Speicherresidente Pro- 
gramme in MS-C« gezeigt wurde, unterstützt der Microsoft 
C-Compiler ab der Version 5.0 die Entwicklung derartiger 
Interrupt-Routinen. 

Durch das Befehlswort interrupt wird es möglich, 
eine Routine als Interrupt-Routine zu kennzeichnen. Die 
einzelnen Prozessorregister können dann nicht nur als loka- 
le Variablen angesprochen und manipuliert werden, son- 
dern die Funktion wird auch durch den Maschinensprache- 
Befehl iret beendet, der die Ausführung wieder mit dem 
Programm fortsetzt, das durch den Aufruf des Interrupts 
unterbrochen wurde. Zusätzlich generiert MSC Maschinen- 
code, mit dessen Hilfe beim Aufruf der Interrupt-Routine 
die Segmentadresse des globalen Variablensegments des C- 
Programms in das DS-Register geladen wird und so auch 
innerhalb der Interrupt-Routine der Zugriff auf globale 
Variablen möglich ist. 

Installiert wird der Interrupt-Handler KbdHandler( ) 
innerhalb der Initialisierungs-Funktion des KBM-Moduls, 
der Funktion KbmInit( ). Mit Hilfe der Bibliotheksfunk- 
tion _dos_getvect( ) wird dort zunächst die Adresse des 
bisherigen Interrupt-Handlers des Interrupts 09h ermittelt 
und in der globalen Variablen O1dKbHandler gespeichert. 
Der neue Interrupt-Handler wird danach mit Hilfe der 
Bibliotheksfunktion _dos_setvect( ) installiert. 

Innerhalb des neuen Tastatur-Handlers wird jeweils 
zunächst der alte Interrupt-Handler aufgerufen, dessen 
Funktionen weder ersetzt werden sollen, noch können. 
Danach wird anhand der globalen Variablen key_avail 
überprüft, ob kein Zeichen im internen Tastaturpuffer des 
KBM-Moduls bereitsteht. Ist dies der Fall, wird anhand der 
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Funktion 01h des BIOS-Tastatur-Interrupts überprüft, ob 
jetzt ein Zeichen zur Verfügung steht und dementsprechend 
das Flagkey_avail auf TRUE oder FALSE gesetzt. 

Die Installation dieses Interrupt-Handlers macht es 
übrigens erforderlich, daß vor der Beendigung eines Pro- 
gramms, das mit den Funktionen aus KBM-Modul arbeitet, 
die Funktion KbmEnd( ) aufgerufen wird, in deren Verlauf 
wieder der alte Interrupt-Handler des Interrupt 09h instal- 
liert wird. Bleibt der KBM-Handler über das Ende des Pro- 
gramms hinaus installiert, kommt es spätestens beim Start 
eines neuen Programms zum Systemabsturz, da dann der 
Code des Interrupt-Handlers von diesem Programm über- 
schrieben wird. 

Nicht ganz so leicht ist es, einen Interrupt-Handler für 
die Maus zu installieren, da es sich hier nicht im eigent- 
lichen Sinne um eine Interrupt-Routine handelt. Vielmehr 
wird dieser Handler nicht direkt von der Maus-Hardware, 
sondern durch den Maustreiber aufgerufen, der speziell zur 
Installation eines solchen Handlers die Funktion 0Ch 
bereitstellt. 

Der Aufruf des Handlers erfolgt dabei nicht über den 
Maschinensprache-Befehl int, sondern über einen soge- 
nannten FAR-Call, wodurch die Routine auch nicht durch 
den Befehl iret, sondern durch den Befehl retf beendet 
werden muß. Deshalb muß die Funktion als FAR deklariert 
und kann nicht als MSC-Interrupt-Funktion kodiert werden, 
was weitreichende Folgen hat, wie gleich noch zu sehen ist. 


S: DIA CK 


Rücksprungadresse zum 

SS:BP+18 
SS:BP+16 
SS:BP+14 
SS:BP+12 
SS:BP+18 
SS:BP+8 
SS:BP+6 
SS:BP+4 
SS:BP+2 

Ss: —— 
SS:BP-2_.—— 


lokale Variablen 


Bild 3: Stackaufbau beim Aufruf einer C-Funktion, die mit 
dem Attribut _saveregs versehen wurde 
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[ Pen BeNNENEENNEENNNNNNENENENNNNENEEREEENN 
sKbRBIBuUfFE11] 
Aufgabe : Speichert den Bereichscode für einen 
bestimmte Bildschirmbereich. 
* Eingabe-Parameter: x1, yi = Eckkoordinaten des Bild- 
* x2, y2_ schirmbereichs 
* CODE = Bereichscode. 
* Return-Kert : keiner 
* : Diese Funktion darf nur innerhalb 
* 
“* 


Info 
dieses Moduls aufgerufen werden. 
FH BEE 


static void KbmIBufFill( BYTE x1, BYTE y1, 
BYTE x2, BYTE y2, BYTE code ) 


{ 
Eegistat BYTE * Iptr; /* Laufzeiger in den Bereichsp. %*/ 
B 1.33 /* Schleifenzähler */ 


/*-- die einzelnen Zeilen durchlaufen 


for (j=x2 - x1 + 1 ; yl <= y2; ++y1) 

{ /* die einzelnen Elemente der Zeile durchlaufen */ 
for (lptr = bpuf+yi*tcol+x1, i = J; i ; --1) 
*(lptr++) = code; /* den Code setzen */ 


} 


PR Ren Me EEE 
* Funktion :MouSetBereich 


: Erlaubt die Definition verschiedener 
Bildschirmbereiche die zur Arbeit 
mit der Maus mit einem bestimnten 
Code versehen werden. 
Eingabe-Parameter: - ANZAHL = Anzahl der Bildschirmber. 
- PTR = Pointer auf Vektor nit Ele- * 
menten vom Typ BEREICH. * 
: keiner “ 
: - Den freibleibenden Bildschirmb. wird * 
der Code KEIN_BEREICH zugewiesen. 
Beim Eintritt in einen der angege- 
benen Bildschirmbereiche schaltet 
der Maus-Handler automatisch auf das 
Erscheinungsbild des Maus-Cursors um, 
das innerhalb der einzelnen Kompo- 
nenten des Vektors angegeben wird. 
Den jeweils aktuellen Bereich können * 
Sie nach der Rückkehr aus der Funk- * 
tion KbmEventWait() mit Hilfe der * 
Funktion MouGetBereich() ermitteln. * 
Der erste Bereich innerhalb des Vek- * 
tors trägt dabei die Nummer 8, der * 


zweite die Nummer 1 usw. * 
DE EEE EEE yZ 


Return-Kert 
Info 


* 
* 
* 
* 
* 
* 
%* 
* 
%* 
* 
* 


EEK EK EEK <« 


void MouSetBereich( BYTE anzahl, BEREICH * ptr ) 
register BYTE i; /* Schleifenzähler */ 


akt_bereich = ptr; /* Pointer auf Vektor und An- */ 
anz bereich = anzahl; /* zahl der Bereiche merken */ 
KbmIBufFill( 8, 8, tcol-1, tline-1, KEIN_BEREICH ); 

for (i=8 ; i<anzahl ; ++ptr ) 

KbmIBufFill( ptr->x1, ptr->yl, ptr->x2, ptr->y2, it+); 


: hartet auf den Eintritt eines be- 
stimmten Ereignisses im Zusammenhang 
nit Tastatur und Maus. 

WAIT_EVENT = Bit-Maske die das zu er- 
wartende Ereignis spezi- 
fiziert. 

: Bit-Maske der eingetretenen Ereignisse 


Listing 2: (Fortsetzung) 
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: = WAIT_EVENT kann durch Oder-Verknüpf- * 
ung der verschiedenen Konstanten vie * 
z.B. EV MOU_MOVE aus der Datei KBM.H * 
ee werden * 

- Die Funktion kehrt erst dann zum * 
Aufrufer zurück, wenn eines oder * 
mehrere der angegebenen Ereignisse * 
%* 

/ 


* 
* 
* 
* 
* 
* 
* 
* 


eintreten. 
EBENEN BE DE BEE EEE EBENE EEE EINEN EEE 


int KbmEventkait( int wait_event ) 


/* die jeweils aktuelle Event-Maske */ 


int akt_event; 
/* letzte Mausposition */ 


register BYTE spalte = moucol, 
zeile = mourow; 
BYTE ende = FALSE; /* wird TRUE, wenn Ereignis eingetreten */ 


MER ( tende ) /* wiederholen, bis Ereignis eingetreten */ 


/#-- warten bis eines der Ereignisse eintritt 


while ( (((akt_event = mouevent) & wait event) == 8) && 
t(((walt_event & EV KEY_AVAIL) T=9) && 
key_availt=FALSE) ) 


akt event &= wait event; /* nur Event-Bits stehenlassen */ 
if T((wait_event & EV KEY AVAIL) t=8) && key availt=FALSE) 
akt_event |= EV_KEY_AVAIL; /* erwartete Taste betätigt */ 


/*-- wenn auf die Bewegung der Maus gewartet wird, wird -*/ 
/*-- das Ereignis nur akzeptiert, wenn die Maus in eine -*/ 
/*-- andere Zeile und/oder Spalte des Textbildschirns -*/ 
/#-- bewegt wird. / 


if (((wait event & EV _MOU_MOVE) != B) && 
(spalte==moucol && zeile==mourow) ) 
/* Maus rg 1% aber gleiche Bildschirmposition 
akt_event &= (”EV_MÖU MOVE); /* Move-Bit ausblenden 
2 = (akt_event t= 9); /* bleiben Events übrig? 


else /* Ereignis eingetreten 
y ende = TRUE; 


/* aktuelle Mausposition und 
/* -bereich in globalen Vari- 
/* ablen festhalten 

/* Event-Maske zurückliefern 


ev_col = moucol; 
ev_ToW = mourow; 
ev ber = mouber; 
return( akt_event ); 


9 0 NENNEN NN 
:KbISetMouseHandler 


: Setzt einen neuen Maus-Handler, der * 

bei Eintritt eines bestimmten Ereig- * 

nisses durch den Maustreiber aufge- * 

rufen wird. * 

Eingabe-Parameter: EVENT = Bit-Maske, die das Ereignis * 
spezifiziert, bei dem der Maus-* 

Handler aufgerufen werden soll.* 

PTR = Pointer auf den Maus-Handler * 

Return-kert : keiner ” 
Info : - EVENT kann durch Oder-Verknüpfung * 
der verschiedenen Konstanten wie z.B.* 

EV_MOU_MOVE gebildet werden. * 

Bad ana 0S 5022020272 0215 0202157212 2021202021272 02 027272121272 12 0272021572 7215 7202787228 272727272 720272 72720272 202.227 


EX KKEKKKEK KK 


ia void KbmISetMouHandler( unsigned event, MOUHAPTR ptr ) 


union REGS regs; /* Prozessorregs für Interruptaufruf */ 
struct SREGS sregs; /* Segmentregister für Interruptaufruf */ 


regs.x.ax = Axddßc; /* Fktnr. für "Set Mouse Handler” */ 
regs.X.cx = event; /* Event-Maske laden */ 
regs.x.dx = FP_OFF( pr );  /* Offsetadresse des Handlers */ 
sregs.es = FP_SEG( ptr ); /* Segmentadresse des Handlers */ 
> NTX( regs, regs, sregs ); /* Maustreiber aufrufen */ 


Listing 2: (Fortsetzung) 


Pe DNB DEE EEE DEE EN EEE NEN NENNEN NIE 


:KbnlGetX 


: Ermittelt die Spalte, in der sich die * 

Maus befindet, * 

* Eingabe-Parameter: keine * 
* Return-kert : die Maus-Spalte in Bezug auf den Text- * 
* 


* Bildschirm 
BEE EEE NEN NEBEN RENEEREEBRNE A EEIANEINRE/ 


guene BYTE KbmIGetX( void ) 


/* Prozessorregs für Interruptaufruf */ 
regs.x.ax= 2xDAD3; /* Fktnr.: für "Get mouse position” */ 

INTERN: regs); /* Maustreiber aufrufen */ 
return XTÖCOL(regs.x.cx); /* Spalte umrechnen und zurückl. */ 


union REGS regs; 


[PER BR DENN NE NEED NENNEN EN ED 


:KbnlGetY 


* : Ermittelt die Zeile, in der sich die * 
“ Maus befindet. * 
* Eingabe-Paranmeter: keine * 
* Return-Wert : die Maus-Zeile in Bezug auf den Text- * 
* 
/ 


Bildschirm 
MEN DEE EEE EEE NEE EEE EEE EEE EEE EEE 


static BYTE KbmIGetY( void ) 


/* Prozessorregs für Interruptaufruf */ 
regs.x.ax= 2xd803; /* Fktnr.: für "Get mouse position” */ 

INT(regs, regs); /* Maustreiber aufrufen */ 
return YTÖROW(regs.x.dx); /* Zeile umrechnen und zurückl. */ 


} 


[IHNEN NN MEN NE N NN NE 
* Funktion :KbnmEnd 
*%* 


: Beendet die Arbeit mit den Funktionen * 
des KBM-Moduls. * 
* Eingabe-Parameter: keine * 


* Return-Wert : keiner * 
EN NER DENE DD DD NND RE / 


union REGS regs; 


void KbmEnd( void ) 


union REGS regs; /* Prozessorregs für Interruptaufruf */ 


/*-- wieder alte Interrupt-Handler installieren 


_dos_setvect( KB _INTR, OldKbHandler ); 
"dos _setvect( CTRLB_INT, OldCtrlBHandler ); 
_dos setvect( CTRLC_INT, OldCtriCHandler ); 


if ( makroanz ) /* sind Makros definiert? */ 
free( makvec ); /* Ja, Makro-Vektor freigeben */ 
if ( fktanz ) /* sind Funktionen definiert? */ 
free( fktvec ); /* Ja, Funktions-Vektor freigeben */ 
free( makrotab ); /* Bit-Tabellen wieder freigeben */ 


MouHideMouse(); /* Maus-Cursor ausblenden */ 
regs.x.ax = ß; /* Reset des Maustreibers */ 
INT(regs, regs); /* Maustreiber aufrufen */ 


3 na RE N 


:Kbalnit 


: Leitet die Arbeit mit dem KBM-Modul 

ein. 

Eingabe-Parameter: keine 

Return-Kert : TRUE, wenn eine Maus installiert ist, 
sonst FALSE 

Info : Diese Funktion muß als erste Funktion 
aus diesem Modul aufgerufen werden. 

EEE EIER DE BEE EEE EEE EEE EEE NE 


EEE Ze Ze ze Ze ze 3 
SKK K 


Listing 2: (Fortsetzung) 
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BYTE KbmInit( void ) 


union REGS regs; /%* Prozessorregs für Interruptaufruf */ 


/%*-- neuen Tastatur-Interrupt-Handler installieren 


OldKbHandler = dos getvect( KB_INTR ); 
_dos_setvect( KB_INTR, KbdHandler ); 


/*-- Gtrl-Break und Ctrl-C-Handler umleiten 


OldCtr1BHandler = _dos_getvect( CTRLB_INT ); 
OldCtrlCHandler = dos getvect( CTRLC_INT ); 
_dos_setvect( CTRLC_INT, BreakHandler ); 
_dos_setvect( CTRLB_INT, BreakHandler ); 


/*-- Puffer für die Makro- und die Funktionstabelle allok. */ 


fkttab = ( makrotab = (BYTE *) malloc( 128 ) ) + 64; 
menset( makrotab, B, 128 ); /* keine Makros, keine Fkt.s */ 
atexit( KbmEnd ); /* am Programmende KbmEnd aufrufen */ 
/* Mouse-Treiber initialisieren */ 
/* Maustreiber aufrufen */ 
/* Maustreiber installiert? %/ 
/* Nein %/ 


regs.x.ax = ß; 
INT(regs, regs); 
if ( regs.x.ax != Bxffff ) 
return FALSE; 


/%*-- vertikale Auflösung des virtuellen Maus-Bildschirms --*/ 
/*-- ermitteln 72 


tline = VioGetLines(); /* Anzahl Zeilen- und Spalten */ 
tcol = VioGetCols(); /* im Textbildschirm ermitteln */ 


/*-- Puffer für Maus-Bereiche allokieren und füllen 


in = (BYTE *) malloc( tline * tcol ); 
KbnIBufFill( 8, 8, tcol-1, tline-1, KEIN_BEREICH ); 


moucol = KbnIGetX(); /* aktuelle Mausposition in %*/ 
mourow = KbmIGetY(); /* globale Variablen laden */ 
KbmISetMouHandler( EV_MOU ALL, MouHandler); 

return mavail = TRUE; /* Maus ist installiert */ 


[ PRaXC N a 
* Funktion :MouShowMouse 


: Maus-Cursor auf dem Bildschirm an- 
zeigen. 
* Eingabe-Parameter: keine 
* Return-kert : keiner 
RENNEN HE NENN ENNENNRINNNENEEENENNE / 


void MouShowMouse( void ) 
/* Prozessorregs für Interruptaufruf */ 


/* Fktnr.: für "Show Mouse” %*/ 
/* Maustreiber aufrufen */ 


union REGS regs; 


ee = dxd001; 
INT(regs, regs); 


} 


ea aa 
:MouHideMouse 


: Maus-Cursor vom dem Bildschirm ent- 
fernen. 
* Eingabe-Parameter: keine 


* Return-hert : keiner 
BR NEBEN BIEBIEBEIEN EEEEEEEEEENE  EEEENNEEEN NENEEEENEN 


void MouHideMouse( void ) 
union REGS regs; 


regs.x.ax = #xddB2; 
INT(regs, regs); 


/* Prozessorregs für Interruptaufruf */ 


/* Fktnr. für "Hide Mouse” %*/ 
/* Maustreiber aufrufen */ 


Listing 2: (Fortsetzung) 
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Probleme ergeben sich bereits daraus, daß der Maus- 
treiber wichtige Informationen, wie die Event-Maske und 
die aktuelle Maus-Position in den verschiedenen Prozessor- 
register übergibt. Die C-Funktion muß deshalb über die 
Möglichkeit verfügen, auf diese Register zugreifen zu kön- 
nen, sie darf sie dabei aber nicht verändern, damit sie dem 
Maustreiber nach der Beendigung der Funktion unverän- 
dert zurückgeliefert werden. C-Funktionen aber verändern 
während ihrer Ausführung normalerweise zumindest die 
Register AX, BX, CX und DX und zerstören damit für den 
Maustreiber unter Umständen wichtige Informationen. 
Dazu kommt noch das Problem, daß sich beim Aufruf des 
Handlers im DS-Register nicht die Segmentadresse des C- 
Datensegments, sondern eine unvorhersehbare Adresse 
befindet und auf die globalen Variablen des C-Programms 
dadurch nicht zugegriffen werden kann. 

Abhilfe schaffen hier zumindest partiell die Befehls- 
wörter _saveregs und_loadds, die MSC ab der Version 
5.1 bei der Deklaration von Funktionen unterstützt. Sie sor- 
gen dafür, daß die jeweilige Funktion bei ihrem Aufruf den 
Inhalt der verschiedenen Prozessorregister auf dem Stack 
sichert und gleichzeitig die Segmentadresse des C-Daten- 
segments in das DS-Register lädt. Bleibt nur noch das Pro- 
blem zu lösen, wie die Inhalte der einzelnen Prozessorregi- 
ster und damit die Event-Maske und die aktuelle Maus- 
Position ermittelt werden können. 

Betrachtet man den Maschinen-Code, den MSC bei der 
Umsetzung einer C-Funktion erzeugt, zeigt sich, daß der 
Stack nicht nur zur Speicherung von Registerinhalten und 
Rücksprungadresse, sondern auch zur Speicherung der 
lokalen Variablen einer Funktion benutzt wird. Sie werden 
nach dem Funktionsaufruf unmittelbar an der Stelle auf 
dem Stack abgelegt, auf die das SP-Register (Stackpointer) 
zeigt. Normalerweise beginnen sie dadurch direkt hinter der 
Rücksprungadresse zum Aufrufer. Bei Verwendung des 
Befehlswortes _saveregs gehen ihnen jedoch noch die 
gesicherten Registerinhalte auf dem Stack voran (Bild ]). 

Dadurch aber, daß man die Adresse einer (lokalen) 
Variablen über den &-Operator ermitteln kann und die 
Entfernung zwischen dieser Variablen und den einzelnen 
Registern bekannt ist, kann man auch auf die Register 
zugreifen, die auf dem Stack gesichert wurden. Ist lova die 
erste lokale Variable in einer _saveregs-Funktion, dann 
liefert der folgende Ausdruck den Inhalt des AX-Registers 
beim Aufruf der Funktion: 

*((unsigned int*) &lova+1®) 

Lassen Sie sich bitte nicht dadurch verwirren, daß in 
dem obigen Ausdruck der Wert 10 als Entfernung zwischen 
der lokalen Variablen und dem AX-Register auf dem Stack 
angegeben wird, obwohl Bild 1 zeigt, daß die Entfernung 20 
und nicht 10 Byte beträgt. Da der obige Ausdruck jedoch 
nicht auf eine Variable vom Typ byte, sondern vom Typ 
unsigned int zugreift, muß der Abstand auch als ein 
Vielfaches der Größe dieses Datentyps angegeben werden: 
( 18 * sizeof( unsigned int ) = 20 ) 
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Auf diese Art und Weise verschafft sich der Maus- 
Handler MouHandler( ) bei seinem Aufruf Zugriff auf die 
Event-Maske, die das Ereignis wiederspiegelt, aufgrund 
dessen der Handler aufgerufen wurde. Darüber hinaus wird 
die aktuelle Mausposition aus den Registern CX und DX 
geladen. Da der Maustreiber die Mausposition intern 
immer in Bezug zu einem virtuellen Grafikbildschirm setzt, 
müssen diese Koordinaten zunächst in das Format des Text- 
bildschirms umgerechnet werden, um für das Modul von 
Wert zu sein. Alle drei Informationen werden dabei in 
globalen Variablen festgehalten. Da der Maus-Handler bei 
jedem Ereignis im Zusammenhang mit der Maus aufgeru- 
fen wird, spiegeln diese Variablen immer die aktuelle Posi- 
tion der Maus und ihren Status wieder. 

Eine weitere Aufgabe kommt dem Maus-Handler im 
Zusammenhang mit der Verwaltung der verschiedenen 
Bildschirmbereiche zu, auf die ich bei der Beschreibung des 
Unterschieds zwischen Maus und Tastatur bereits einge- 
gangen bin. Zunächst ermittelt er aus der aktuellen Maus- 
position immer die Nummer des Bereichs, in dem sich die 
Maus befindet. (Bereiche werden über die Funktion Mou- 
SetBereich( ) definiert, die später noch vorgestellt wird.) 
Diese Information speichert er ebenfalls in einer globalen 
Variablen ab, wobei er jedoch zunächst überprüft, ob die 
Maus in einen neuen Bereich bewegt wurde. Da jeder 
Bereich dem Maus-Cursor ein eigenes Erscheinungsbild 
zuweisen kann, schaltet er in diesem Fall auf das Erschei- 
nungsbild des neuen Bereichs um. 

Damit schließt sich der Kreis und wir gelangen wieder 
zum Ursprung unserer Betrachtungen, der Funktion Kbm- 
EventWait( ), zurück. Sie nämlich fragt die verschiedenen 
Ereignisse über die globalen Variablen ab, die durch den 
Maus- und Tastatur-Handler beeinflußt werden. So erkennt 
sie sofort den Eintritt des gewünschten Ereignisses und 
kann die Koordinaten der aktuellen Mausposition und die 
Nummer des Mausbereichs in spezielle globale Variablen 
laden, aus denen der Aufrufer diese Informationen später 
beziehen kann. Danach übergibt sie die Kontrolle wieder an 
den Aufrufer, der über die zurückgelieferte Ereignismaske 
feststellen kann, welches der erwarteten Ereignisse einge- 
treten ist. 

Stellt der Aufrufer dabei z.B. fest, daß jetzt eine Taste 
bereitsteht, kann er diese über die Funktion KbdGetKey( ) 
abfragen, die den Code der Taste an den Aufrufer zurück- 
liefert. Wie auch alle anderen Funktionen innerhalb des 
KBM-Moduls, die mit Tastencodes zu tun haben, wird der 
Tastencode dabei nicht in Form einer char-Variable, son- 
dern als Datentyp TASTE zurückgeliefert, der einem un- 
signed int entspricht. Dadurch können die Codes der 
ASCHI-Zeichen und die erweiterten Tastaturcodes der Cur- 
sor- und Steuertasten mit jeweils nur einer Variablen reprä- 
sentiert werden. Ein Tastencode mit einem Wert kleiner 
oder gleich 255 spiegelt dabei den Code eines ASCII-Zei- 
chens wieder, während die Codes ab 256 den erweiterten 
Tastaturcodes vorbehalten sind. 


WHEN NENNEN NENNEN N NN NA 
:MouSetMoveArea 


* 
7 
c 
En 
+ 
- 
© 
3 


: Definiert den Bildschirmbereich, in * 

dem sich die Maus bewegen darf * 

Eingabe-Parameter: x1, y! = Eckkoordinaten des Bild- * 
‚y2 schirmbereichs * 

Return-Wert : keiner * 
Info : Befindet sich die Maus nicht in dm * 
angegebenen Bildschirmbereich, wird * 

* 
/ 


sie automatisch dorthin versetzt. 
RHEIN EEE EEE RE 


nk x F4 


void MouSetMoveArea( BYTE x1, BYTE y1, BYTE x2, BYTE y2 ) 


union REGS regs; /* Prozessorregs für Interruptaufruf */ 
regs.x.ax = Pxffde; /* Fktnr. für "Set vertical Limits” */ 
regs.x.cx = ROWTOY( na_yl = yi); 
regs.x.dx = ROWTOY( ma_y2 = y2 ); 

INT(regs, a: /* Maustreiber aufrufen */ 
regs.x.ax = Oxd /* Fktnr. für "Set horizontal Limits” */ 
du x.cx = COLTOX( ma_x1 = x1 33 

s.x.dx = COLTOX( ma_x2 = x2 ); 


INT(regs, regs); /* Maustreiber aufrufen */ 


JRR ER BIENEN EEE NE N N DEE 
* „EUIREAON :MouPushPara 


* : Sichert die aktuellen Maus-Paraneter * 
* auf einem internen Stack * 
* Eingabe-Parameter: keine * 
* Return-kert * 
* Info : - zu den aktuellen Maus-Parametern * 
* zählen folgende Angaben: * 
* - die Mausbereiche * 
% * 
* * 
* % 
* % 
* * 
* / 


te 


: keiner 


- der Standard-Maus-Cursor 
- die Maus-Area (Bewegungsbereich) 
- Der Aufrufer hat dafür Sorge zu tra- 
en, daß der Stack nicht überläuft 
nicht mehr als MAX_STACK-Einträge) 


FR De DE 


yes MouPushPara( void ) 


/*-- die verschiedenen Parameter auf dem Stack 
/#*-- sichern und den Stack-Pointer inkrementieren 


stackptr->anz_bereich = anz_bereich; 
stackptr-Istdptr = stdptr; 
stackptr->akt_bereich = akt_bereich; 
stackptr->x! = ma_xl; 

stackptr->x2 = ma „Me; 

rn = may 

es ptr++)->y2 = = _y2; 


BEE N N N 
* Funktion :MouPopPara 


: Über die Funktionn MouPushPara ge- 
sicherte Maus-Parameter wieder vom 
internen Stack holen und aktivieren. 

Eingabe-Parameter: keine 

Return-kert : keiner 

Info : - eine Übersicht über die Maus-Para- 

meter finden Sie bei MouPushPara. 

- Der Aufrufer muß dafür Sorge tragen, 
daß die Anzahl der Aufrufe von 
MouPushPara() und MouPopPara() aus- 
balanciert ist. 

DEIN ER IE IN RENNEN / 


Aufgabe 


EX KKEKRKEE « 2 
KREKXKKEKEKEKK 


- MouPopPara( void ) 


--stackptr; /* den Stackpointer dekrnentieren */ 


Listing 2: (Fortsetzung) 
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/*-- die verschiedenen Paraneter über die jeweilige 
/*-- Funktion wieder restaurieren 


MouSetMoveArea( stackptr->x1, stackptr->y1, 

stackptr->x2, stackptr->y2 ); 
MouSetBereich(stackptr->anz_bereich, stackptr->akt_bereich); 
IDEEN stackptr-Istdptr ); 


HEMER RN NENNEN NENNEN 
:MouSetSpeed 


Aufgabe : Setzt die Maus-Geschwindigkeit 
Eingabe-Parameter: - XSPEED = Sms hiäge got in hori- 
zontaler R u 
- YSPEED = Geschwindigkeit In verti- 
kaler Richtung 
Return-hert : keiner 
Info : = Beide eg; pro beziehen sich auf die 
Einheit Mickey / Pixel. Erlaubt ist 
die Angabe von Werten zwischen 1 und 
32767. 
- Der Defaultwert für XSPEED ist 8, 
der für YSPEED 16. 


HEHE DE DENE HE BD BENENNEN EM N RE 


ZKEKKKEKEEK KK K $ 
De ZE Ze 22 ZE 22 Zu zu Zu Ze zu u © 


von MouSetSpeed( int xspeed, int yspeed ) 


union REGS regs; /* Prozessorregs für Interruptaufruf */ 
regs.x.ax = Bxdßdf; /* Fktnr. "Set mickeys to pixel ratio” */ 
regs.x.cx = xspeed; 
regs.x.dx = yspeed; 


INT(regs, regs); /* Maustreiber aufrufen */ 


[RR N NN 
* Funktion :MouSetPtr 
** 


: gt den Masu-Cursor an eine be- 
stimmte Bildschirmposition. 

* Eingabe-Paraneter: - COL = Bildschirnspalte 

* = ROW = Bildschirnzeile 

* Return-Wert : keiner 

* Info : = Beide Angaben beziehen sich auf den 

* 

* 


* Aufgabe 
* 


Textbildschirn. 
N HEN HE BE ER DE DE ED DE BD BIENEN DD DD DE EINEN 


ae MouSetPtr( int col, int row ) 


union REGS Er /* Prozessorregs für Interruptaufruf 
unsigned bereich; /* Bereich, in den die Maus bewegt wird 


regs.x.ax = ÖxdBB4; /* Fktnr. "Set mouse pointer position” 
regs.x.cx = COLTOX( moucol = col ); 
regs.x.dx = ROWTOY( mourow = row ); 

INT(regs, regs); /%* Maustreiber aufrufen 


bereich = *(bpuf + mourow * tcol + moucol); /# Ber. holen */ 

if ( bereich != mouber ) /* neuer Bereich? %*/ 

MouDefinePtr( (bereich == KEIN BEREICH) ? /* Ja %/ 
stdptr : (akt bereich+bereich)->ptr_mask ); 

mouber = bereich; /# Bereichsnr. in globaler Var. merken */ 


PREMIEREN RBB IB NENNEN EEE 
:MouDefinePtr 


: Legt die beiden Bit-Masken für die 
Erzeugung des Maus-Cursors fest. 
Eingabe-Parameter: MASK = die beiden Bit-Masken 
Return-Wert : keiner 
Info : - Der für MASK übergebene kert sollte 
mit Hilfe des Makros MouPtrMask und 
der zugehörigen Konstanten aus der 
Inciude-Datei KBM.H erstellt werden. 
BER EINEN NENNEN NENNEN NENNEN EEE NE / 


“ER KEKK x * 


Listing 2: (Fortsetzung) 
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#pragsa check_stack(off) /* kein Stack-Checking hier 


"ya MouDefinePtr( PTRVIEK mask ) 


union REGS regs; /* Prozessorregs für Interruptaufruf 
regs.x.ax = OxBöda; /* Fktnr. für "Set text pointer type” 
regs.x.bx = 8; /* Software-Cursor einstellen 
regs.x.cx = mask; /%* Lo-kord ist AND-Maske 
regs.x.dx = mask >> 16; /* Hi-Word ist XOR-Maske 

INT(regs, regs); /* Maustreiber aufrufen 


/* alten Zustand im Hinblick auf das 


#pragma check_stack 
/* Stack-Checking wieder herstellen */ 


/pragma check_stack 


[a MEER N BRENNEN NEE 


:MouSetDefaultPtr 


: Definiert das Erscheinungsbild des 
Maus-Cursors, wenn sich die Maus nicht 
in einem spezifizierten Bereich be- 
findet. 
Eingabe-Parameter: STANDARD = Bit-Maske für den Standard- 
Maus-Cursor 
Return-Wert : keiner 
Info : = Der für MASK übergebene kert sollte 
mit Hilfe der Makros PTRSAMECHAR 
etc., die in der Include-Datei KBM.H 


definiert werden, erstellt werden. 
EHE DEE IE EEE BR MM DD DEE DB DD DEE EEE 


Fe MouSetDefaultPtr( PTRVIEW standard ) 


stdptr = standard; /* Bit-Maske in globaler Var. merken */ 
/%*-- befindet sich die Maus im Augenblick in keinem Be- ---*/ 
/*-- reich, wird der Maus-Cursor direkt auf das neue EN 
/*-- Erscheinungsbild umgeschaltet. —r/ 


if ( MouGetBereich() == KEIN BEREICH ) 
MouDefinePtr( standard ); 


[RRORKENE NEN NENNE EBENE NENNEN NENNEN NE NE 


:KbdlIPutKey 


& Fin einen Tastencode an das Ende 
des internen Tastaturpuffers 

Eingabe-Parameter: KEY = der Tastencode 

Return-hert : keiner 

Info : Der Aufrufer ist dafür verantwortlich, 


daß der Tastaturpuffer nicht überläuft.* 
RBHRBRBRRRREREREREIKEBBKERBBEBOBERBBRBBEBEIBBIBBIBRNG/ 


in void KbdIPutKey( TASTE key ) 


*kbend++ = key; /* eine Taste in den Tastaturpuffer laden */ 
if (kbend == key _buf+KB_LEN) /* Ende des Puffers erreicht? */ 
; kbend = key_buf; /%* Ja, wieder am Anfang beginnen */ 


[MR EEE EEE EEE NENNEN EEE 


:KbdINextKey 


* 
= 
ec 
En 
+ 
_ 
o 
>] 


Aufgabe : zur einen Tastencode an den Anfang 
des internen Tastaturpuffers 

Eingabe-Parameter: KEY = der Tastencode 

Return-kert : keiner 

Info : Im Gegensatz zu KbdIPutKey hängt diese 
Funktion den Tastencode nicht an das 
Ende des Tastaturpuffers an, sondern 
stellt ihn als nächsten zu lesenden 
Tastaturcode an den Anfang des Puffers.* 

BENENNEN EBENE NENNE BIENEN NENNEN NENNE NE 


ZKEKKEKKKEK K = 
XKEKKKKE K 


Listing 2: (Fortsetzung) 


SAA-Benutzeroberfläche in C 


aa KbdINextKey( TASTE key ) 


if (--kbstart < key buf) /®* Anfang des Puffers erreicht? */ 

kbstart = key_buf+RB_LEN-1; /* Ja, auf Ende des P. setzen */ 
*kbstart = key; /* den Tastencode in den Tastaturp. laden */ 
a aaa = TRUE; /* jetzt steht ein Zeichen zur Verfüfung */ 


[Pe MER EEEEE EBEEEEEEEEENRER EB EEE 
:KbdlIFindMac 


: Sucht ein Tastaturmakro innerhalb des 
Vektors mit den Makrobeschreibern. 
Eingabe-Parameter: KEY = Tastencode des Makros 
Return-kert : Pointer auf die Makro-Struktur 
Info : Der Aufrufer sollte sich vor dem Auf- 
ruft dieser Funktion vergewissern, 
daß das Makro definiert ist. Nur in 
diesem Fall makht der Aufruf dieser 
Funktion Sinn. 


HEHE NEE NEE HERE HE DEIENENE DENE BI DE DE DEE EBENE BEE EEE EBENE EEE EEE 
static KEY_MAK * KbdIFindMak( TASTE key ) 

Tadialee KEY_MAK * Iptr; /* Laufzeiger in Vektor */ 
/*-- den Vektor mit den Makrobeschreibern durchlaufen 

for (lptr = makvec; lptr->key != key; ++lptr ) 


/* Pointer zurückliefern */ 


return Iptr; 


PRRBRRREBRRBBBRREBBREBBBRRERGRRBEBBRBRRBBBBBRBIGGBRBBBEBBISIGBE 
:KbdIFindrFkt 


: Sucht die I Ya zwischen einer * 
Taste und einer ion im Vektor mit * 
den Funktionsbeschreibern. 
Eingabe-Parameter: KEY = Tastencode der zugeord. Taste 
Return-kert : Pointer auf den Funktions-Beschreiber 
Info : siehe KbdIFindMak 


UEEHEHENE EEE NE NENNE NENNEN HEHE NEE BE BEBE: ERHEBEN / 


ee KEY_FKT * KbdIFindFkt( TASTE key ) 
register KEY_FKT * 1ptr; /* Laufzeiger in Vektor */ 


/*-- den Vektor mit den Makrobeschreibern durchlaufen 
for (lptr = fktvec; Iptr->key t= key; ++Iptr ) 


return lptr; /* Pointer zurückliefern */ 


360 ME EEE NENNEN 


:KbdIGetKey 


: Holt einen Tastencode aus dem inter- 
nen Tastaturpuffer. 
keine 


* 

* 

* Eingabe-Parameter * 
der Tastencode * 
* 

* 

/ 


Return-Wert 
* Info 
* 


: Steht kein Tastencode zur Verfügung, 
wird der Wert dxffff zurückgeliefert. 
EaaLä 2 2 202 212.2 .202 1202120202020 2021202020202 0202 020272727202 702 7272720272727 27271272 712 72127271272727 2712712727272 7272727273 


en KbdIGetKey( void ) 
register int retcode; 


if ( KbEnpty() ) 
return( Äxffff ); 


/*- es steht eine Taste bereit 

retcode = *kbstart++; /* einen Tastencode lesen */ 
if (kbstart == key buf+KB LEN) /#* Ende des P. erreicht? */ 
kbstart = key_buf; /* Ja, wieder am Anfang beginnen */ 
return retcode; /* Tastencode zurückliefern */ 


/* Tastaturpuffer leer? */ 
/* Ja, mit Fehler zurück */ 


Listing 2: (Fortsetzung) 


Die Codes dieser Tasten werden in der Include-Datei 
KBM.H als Konstanten deklariert und können dadurch leicht 
in den Programmablauf eingebunden werden. 


Die Include-Datei KBM.H 


Die Include-Datei KBM.H ist der Schlüssel zum Zugriff auf 
die Funktionen des KBM-Moduls. In ihr finden sich neben 
den Typdefinitionen, die zur Arbeit mit den verschiedenen 
Funktionen benötigt werden, auch die Event-Codes für die 
verschiedenen Ereignisse und die Konstanten, die die erwei- 
terten Tastaturcodes repräsentieren. Zusätzlich finden Sie 
hier die Deklarationen der verschiedenen Funktionen aus 
dem KBM-Modul und verschiedene Makros, die im folgen- 
den vorgestellt werden. 


MouGetCol(: Liefert die Bildschirmspalte, in der sich der 
Maus-Cursor bei der letzten Rückkehr aus KbmEvent- 
Wait( ) befand. 

MouGetRow(): Liefert die Bildschirmzeile, in der sich der 
Maus-Cursor bei der letzten Rückkehr aus KbmEvent- 
Wait() befand. 

MouGetBereich(): Liefert die Nummer des Bereichs, in 
dem sich der Maus-Cursor bei der letzten Rückkehr aus 
KbmEventWait( ) befand. Wird hier der Wert der Kon- 
stanten KEIN_BEREICH zurückgeliefert, dann befand sich 
der Maus-Cursor in keinem der über MouSetBereich() 
angegebenen Bildschirmbereiche. 

IsAKey(): Liefert einen Wert ungleich 0 (true), wenn der 
übergebene Code den Code einer ASCII-Taste repräsen- 
tiert. 

IsXKey(): Liefert einen Wert ungleich 0 (true), wenn der 
übergebene Code einen erweiterten Tastaturcode darstellt. 
MouAvail(): Liefert TRUE, wenn eine Maus und ein zuge- 
höriger Maustreiber installiert ist. 

KEY(: Sollte zum Casten einer Variable vom Typ char in 
eine Variable vom Typ TASTE verwendet werden, da der 
Variablentyp char für MSC vorzeichenbehaftet ist und er 
bei einer automatischen Typumwandlung das Vorzeichen 
expandiert, was hier zu einem falschen Resultat führen 
kann. 

MouGetAktCol(: Liefert die aktuelle Bildschirmspalte, in 
der sich der Maus-Cursor befindet. 

MouGetAktRow(): Liefert die aktuelle Bildschirmzeile, in 
der sich der Maus-Cursor befindet. 

IsFkt(): Liefert einen Wert ungleich 0 (true), wenn der 
angegebene Tastencode mit einer Funktion verknüpft ist, 
die bei der Betätigung dieser Taste aufgerufen wird. (Siehe 
dazu KbdSetFkt() ) 

IsMakro(): Handelt es sich bei dem angegebenen Tastatur- 
code um den Code eines Tastaturmakros, liefert dieses 
Makro einen Wert ungleich 0 zurück (true). (Siehe dazu 
auch KbmSetMakro()) 

ELVEK(): Liefert die Anzahl der Elemente im angegebe- 
nen Vektor zurück. 
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MouPtrMask(): Erlaubt die Erstellung einer Bit-Maske für 
das Erscheinungsbild des Maus-Cursors, das z.B. beim Auf- 
ruf der Funktionen MouDefinePtr() und MouSetDe- 
faultPtr() angegeben werden kann. Als erster Para- 
meter muß diesem Makro entweder die Konstante PTR- 
SAMECHAR oder die Konstante PTRDIFCHAR( ) übergeben 
werden. Als zweiter Parameter kommen die Konstanten 
PTRSAMECOL, PTRINVCOL, PTRSAMECOLB, PTRINVCOLB, 
PTRDIFCOL( ) und PTRDIFCOLB( ) in Frage. 
MouSetMoveAreaAll(): Definiert den gesamten Bildschirm 
als den Bewegungsbereich der Maus, so daß sich der Maus- 
Cursor ungehindert bewegen kann. 

KbdUngetKey(): Schiebt die angegebene Taste an den 
Anfang des internen Tastaturpuffers, so daß sie beim näch- 
sten Aufruf von KbdGetKey( ) wieder zurückgeliefert wird. 


Funktionen aus dem Modul KBM.C 


Im folgenden werden die einzelnen Funktionen vorgestellt, 
die Ihnen das KBM-Modul zum Aufruf bereitstellt. Es geht 
dabei primär darum, die Aufgabe der jeweiligen Funktion 
und ihre Stellung innerhalb des Moduls als Ganzem zu 
beleuchten. Die zu übergebenden Parameter und ihre Be- 
deutung sowie die Art des Rückgabewerts entnehmen Sie 
bitte dem Listing des Moduls, das ausführlich dokumentiert 
ist und keine Fragen offen lassen sollte. 

Kbmlnit(): Dies ist die Initialisierungsfunktion des Moduls, 
die als erste Funktion aus diesem Modul aufgerufen werden 
muß, um verschiedene Variablen zu initialisieren und die 
beiden Interrupt-Handler zu installieren. Die sie auf ver- 
schiedenen Funktionen aus dem VIO-Modul zugreift, das in 
der ersten Folge dieser Serie vorgestellt wurde, sollte diese 
Funktion erst nach der Initialisierung des VIO-Moduls, also 
nach dem Aufruf von VioInit( ), aufgerufen werden. 
KbmEnd(): Diese Funktion schließt die Arbeit mit dem 
KBM-Modul ab, indem sie die allokierten Puffer wieder 
freigibt und die installierten Handler für Maus und Tastatur 
wieder deaktiviert. Sie müssen diese Funktion allerdings 
nicht explizit aufrufen, da KbmInit() sie mit Hilfe der 
Bibliotheksfunktion _atexit() als eine Funktion festlegt, 
die bei der Beendigung des Programms automatisch aufge- 
rufen werden soll. 

KbmEventWait(): Diese Funktion wurde oben bereits 
besprochen. Sie erlaubt Ihnen, auf ein bestimmtes Ereignis 
im Hinblick auf die Maus oder die Tastatur zu warten. 
MousSetBereich(): Mit Hilfe dieser Funktion können Sie die 
verschiedenen Bildschirmbereiche und die zugehörige 
Maske für den Maus-Cursor definieren. 

MouShowMouse(): Bringt den Maus-Cursor auf den Bild- 
schirm. Der Maustreiber verwaltet einen internen Zähler, 
mit dem er die Anzahl der Aufrufe der Funktionen Mou- 
HideMouse( ) und MouShowMouse( ) festhält. Die Maus 
wir nur angezeigt, bzw. vom Bildschirm entfernt, wenn die 
Anzahl dieser Aufruf ausgeglichen ist. 
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#3 MEERE BRENNENNNNBNNENN RNERNNNNENNN 
:KbdGetKey 


Aufgabe : Holt eine Taste von der Tastatur. 

Eingabe-Paraneter: keine 

Return-Wert : Code der Taste 

(siehe dazu Konstanten in KBM.H) 

Info : - Steht kein Zeichen bereit, wartet 
die Funktion auf die Betätigung 
einer Taste. 

NEE BB BB EEE DENE BIENEN NEIN NENNE HEHE 


en KbdGetKey( void ) 


TASTE key; 

KEY_MAK *makro; 

ie ro TASTE *lptr; 
int 1; 


/* Pointer auf Makrobeschreiber #/ 

/* Laufzeiger in Makropuffer %/ 

* Schleifenzähler %*/ 

ia ( TRUE ) /* Endlosschliefe */ 

while ( key avail == FALSE ) /*warten, bis Taste betätigt*/ 
/#-- alle Zeichen aus den BIOS-Tastaturpuffer holen 

MUT ( _bios_keybrd( _KEYBRD_READY ) ) /*weitere Taste?#/ 


/" Ja */ 
key = bios_keybrd( KEYBRD READ ); /* Taste holen #/ 


KbdlPutkey( (key & DXff) ? (key & Bxff) /* & in Puffer */ 
: key >> 8 | Bx1dß ); 


/* Taste aus Puffer holen */ 
/* Makroaufruf? %/ 


/* Ja */ 
/* Beschreiber suchen %*/ 


} 
key = KbdIGetkey(); 
if ( ( key & KEY_EXPANDED ) == 8 && 
IsMakro( key ) ) 


makro = KbdIFindMak( key ); 


/#-- Makrozeichen in den internen Tastaturp. bringen --*/ 

if ( (1 = makro-Janzahl - 1) != -1) /* Länge nicht 8? */ 

/* Nein */ 

for ( lptr = makro->bufptr + 1; /* das Makro durchl. */ 
i--: 


lpt: ) 
KbdINextKey( *lptr | KEY_EXPANDED ); 
„9 = *]ptr; /%* erstes Makrozeichen direkt übergeben */ 


} 


key &= ("KEY EXPANDED); 
key avail = TKbEnpty(); 


/* Makro-Bit ausblenden */ 

/* Tastaturpuffer jetzt leer? */ 
if ( Isfkt( key ) ) /* Funktion aufrufen? */ 
( KbdIFindFkt( key )->fkt )(); /* Ja, do it %®/ 

else /* Nein %/ 
break; /* aus der Endlosschleife springen */ 


if ( lern && lblen ) 
{ /# Ja ®/ 


*]bakt++ = key; /* Taste im übergebenen Puffer merken %*/ 
--1blen; /%* Anzahl verbleibender Tasten dekrementieren */ 


/* im Aufzeichnungsmodus? */ 


return key; /%* Tastencode an Aufrufer zurückliefern */ 


4303030 BENENNEN NEE NENNEN 
* Funktion :KbdFlushBuf 


: Löscht den internen und den BIOS- 
Tastatur-Puffer 
* Eingabe-Parameter: keine 


* Return-Kert : keiner 
RE EHEN NEE I RE NEBEN IE NEBENAN 


void KbdFlushBuf( void ) 
/#*-- alle Zeichen aus dem BIOS-Tastaturpuffer holen 


while ( 


bios keybrd( KEYBRD_ READY ) ) /* noch 'ne Taste? */ 
_bios_keybrd( _KEYBRD_READ ); 


/* Ja, Taste holen */ 


Listing 2: (Fortsetzung) 


SAA-Benutzeroberfläche in C 


kbstart = kbend = key_buf; /* kein Zeichen mehr im Puffer */ 
a ae = FALSE; /* kein Zeichen verfügbar */ 


[RENNEN NENNEN NENNEN NEE EN IIAEE 
:KbdClearAllMacs 


: Löscht alle angelegten Tastatur-Makros.* 
* Eingabe-Parameter: keine * 


* Return-Wert : keiner * 
BEHEEIENENERENEDNEENEEEHENEEE ENEENE EENNENENEEEENNEENENNENEEN / 


aa KBdClearAllMaks( void ) 
if ( makroanz ) /* sind überhaupt Makros definiert? */ 
{ /* Ja %/ 
memset( makrotab, Ö, 64 ); /* Bit-Tabelle löschen */ 
free( makvec ); 


/* Vektor mit Makrobeschr. freigeben #*/ 
zrenn =; /%* keine Makros mehr verfügbar %*/ 


} 


[ABONNIEREN NE 
* Funktion :KbdDelMacro 
23 


ga : Löscht ein Tastaturmakro. 
* Eingabe-Parameter: - KEY = Tastencode der Nakrotaste 


* Return-Wert : keiner 
RENNEN NENNEN NEE NENNEN NE NENNE NENNEN 


void KbdDelMakro( TASTE key ) 


static KEY_MAK *makro; 
int i; 


Y ( IsMakro( key ) ) 


if ( makroanz == 1 ) /* ist nur ein Makro definiert? */ 
free( makvec ); /* Speicher des Makro-Vektors freig. */ 
else /* es sind mehrere Makros definiert */ 
{ /* die nachfolgenden Makrobeschreiber heranziehen */ 
makro = KbdIFindMak( key ); /* Ja, Adresse ermitteln */ 
1 = makro - makvec; /* Nummer des Elements im Vektor */ 
memmove(makro, makrot!, (makroanz-i-1)*sizeof(KEY_MAK)); 
makvec = realloc(makvec, 
} ( makroanz-1 ) * sizeof( KEY_MAK )); 


--makroanz; /* Anzahl der Makros dekrementieren */ 
/%*-- entsprechendes Bit in der Makro-Tabelle löschen ----*/ 
Ne + (key >> 3)) &= "(1 << (key & 7)); 


/* Pointer auf Makro-Struktur */ 


/* ist das Makro definiert? */ 
/" Ja %*/ 


[PR ad BR BE 
:KbdSetMacro 


Aufgabe : Definiert ein Tastaturmakro. 
Eingabe-Parameter: - KEY_ = Tastencode der Makrotaste 
- PTR = Ptr. auf Vektor mit den um- 
zusetzenden Tastencodes. 
- ANZAHL= Anzahl der Tasten im Vektor 
: TRUE, wenn das Makro angelegt werden 
konnte, sonst FALSE 
Info : Während das Makro aktiv ist, darf der 
Inhalt des übergebenen Vektors nicht 


verändert werden. 
UNE NEBEN DE NEE DEE EBENE BENENNEN DE DE DEE DEE DE EHE BE NEE DENE DENE NE NENNEN NENNEN NINE I IE HEHEIE HE 


Return-Wert 


SEK EKKEKK x 


BYTE KbdSetMakro( TASTE key, TASTE *ptr, BYTE anzahl ) 


{ 
register KEY_MAK *makro; 


if ( IsMakro( key ) ) 
makro = KbdIFindMak( key ); 
are /* Makro ist noch nicht definiert */ 


/* Pointer auf Makro-Struktur */ 


/* ist Makro bereits definiert? */ 
/* Ja, Adresse ermitteln */ 


Listing 2: (Fortsetzung) 


2 ( makroanz ) /* ist schon ein Makro definiert? */ 

makro = realloc( makvec, (makroanz+1)*sizeof(KEY_MAK) ); 

if ( makro ) /* konnte der Puffer vergrößert werden? */ 
{ /* Ja */ 
makvec = makro; /* neue Vektoradresse merken */ 
makro += makroanz++; /* Ptr auf neuen Beschr. setzen */ 


/%* Nein */ 

/%* zunächst Speicher für Makro-Vektor allokieren */ 
makvec = makro = (KEY MAK *) malloc( sizeof(KEY_MAK) ); 

if ( makro ) /* Konnte Speicher allokiert werden? */ 

makroanz = 1; /* Ja, jetzt ist ein Makro definiert */ 


/* alles 0.k.? */ 
/* ja */ 


} 
“ ( makro ) 
/* Daten in die Struktur laden */ 


makro->key = key; 
makro->bufptr = ptr; 
makro->anzahl = anzahl; 


/*-- entsprechendes Bit in der Makro-Tabelle setzen 
*(makrotab + (key >> 3)) I= (1 << (key & 7)); 
in TRUE; 


else /* es konnte kein Speicher allokiert werden */ 
return FALSE; 


[30 He EN NN NENNE 


* Funktion :KbdClearAllFfkt 
*% 


* Aufgabe 


» Löscht alle eb ga Sap Verknüpfungen 

* zwischen einer Taste * 
* tion. * 
* Eingabe-Parameter: keine * 
* 5 * 


und einer Funk- 


Return-kert : keiner 
AD BEE NENNEN NENNEN NA NENNEN / 


a KBdClearAllfkt( void ) 
“ ( fktanz ) /* sind überhaupt Verknüpfungen re = 
* Ja % 
memset( fkttab, 8, 64 ); /* Bit-Tabelle löschen %*/ 


free( fktvec ); /* Vektor mit Funktionsbeschr. freigeben #/ 
älkac =; /* keine Verknüpfungen mehr definiert */ 


} 


PRBRRBBBREBBRRBRBRREBERRBBRRRBBBRRERBRRGGNRRRBBRBBGGEBSBBRREEER 
* Funktion :KbdDelFkt 


: Löscht die Verknüpfung zwischen einer * 

Taste und einer Funktion. * 

* Eingabe-Parameter: - KEY = Tastencode der Taste “ 
* Return-Wert : keiner hy 
BRENNER NEN EEE / 


void KbdDelfkt( TASTE key ) 


u. KEY_FKT *fkt; /#* Pointer auf Funktionsbeschreiber */ 
nt i; 
if ( Isfkt( key ) ) /* ist die Verknüpfung definiert? %/ 
{ /# Ja */ 
if ( fktanz == 1 ) /* ist nur eine Verknüpfung definiert?%*/ 
free( fktvec ); /* Ja, Speicher des Fkt.-Vektors freig. */ 
else /* es sind mehrere Verknüpfungen definiert */ 
{ /* die nachfolgenden Fkt.beschreiber heranziehen */ 
fkt = KbdlFindfkt( key ); /* Adresse Beschr. ermitteln */ 
i = fkt - fktvec; /* Nummer des Beschreibers im Vektor */ 
memmove(fkt, fkt+1, (fktanz-i-1)*sizeof(KEY FKT)); 
fktvec = realloc(fktvec, (fktanz-1) * sizeof( KEY_FKT )); 


--fktanz; /* Anzahl der Verknüpfungen dekrementieren */ 
/%*-- entsprechendes Bit in der Fkt.-Tabelle löschen #/ 
m + (key >» 3)) &= "(1 << (key & 7)); 


Listing 2: (Fortsetzung) 
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PRRRRBBBABBRRBBBRSRERBRABBBBEGRREGBBREHBERERBROGBBRIEISGBHRIESGEREN 
:KbdSetFkt 


“x 


* : Definiert die Verknüpfung zwischen 

* einem Tastencode und einer Funktion, 
* die beim Empfang dieses Tastencodes 
* innerhalb der Funktion KbdGetKey auf- 
* gerufen wird. 

* Eingabe-Parameter: - KEY = Tastencode 
* 

* 

* 

* 

* 


ze x 


- FKTPTR= Pointer auf die aufzurufende 
Funktion. 

: TRUE, wenn die Verknü Age hergestellt * 

wreden konnte, sonst FALS * 

REINE NENNE NENNEN NEN RENNEN NENNEN NAEH / 


Return-Wert 


Fels KbdSetFkt( TASTE key, FKTPTR fktptr ) 
register KEY_FKT *fkt; 
if ( IsFkt( key ) ) /* ist Verknüpfung bereits definiert? */ 


fkt = KbdIFindFkt( key ); /* Ja, Adresse ermitteln */ 
else /* Verknüpfung ist noch nicht definiert */ 


/* Pointer auf Fkt.Beschreiber */ 


if ( fktanz ) /%* ist schon eine Verknüpfung definiert? */ 

{ /* Ja, Vektor mit Fkt-Beschreibern vergrössern */ 
fkt = realloc( fktvec, (fktanz+1)*sizeof(KEY_FKT) ); 

if ( fkt ) /* konnte der Puffer vergrößert werden? */ 

{ /# Ja ®/ 

fktvec = fkt; /* neue Vektoradresse merken */ 

gm += fktanz++; /®* Ptr auf neuen Beschr. setzen */ 

} 


else /* Nein %/ 
/* zunächst Speicher für Fkt-Vektor allokieren */ 

fktvec = fkt = (KEY *) malloc( sizeof(KEY FKT) ); 
if ( fkt ) /* konnte Speicher allokiert werden? */ 
j fktanz = 1; /* Ja, jetzt ist eine Verk. definiert */ 


/* alles 0.k.? %/ 
/* ja ®/ 
/* Daten in die Stuktur laden */ 


} 

3: ( fkt ) 
fkt->key = key; 
fkt->fkt = fktptr; 


/#*-- entsprechendes Bit in der Fkt.-Tabelle setzen 


*(fkttab + (key >> 3)) I= (1 << (key & 7)); 
return TRUE; 


else /* es konnte kein Speicher allokiert werden */ 
return FALSE; 


/ Pe E NENNEN NEAR IE EEE NENNEN NENNEN 
:KbdLearn 


: be die Aufzeichnung von Tasten- 
olgen. 
Eingabe-Parameter: - 


“x 


Aufgabe 


= Pointer auf den Lern-Puffer, 
in den die Tastatur-Routine 
die Tastenfolge einträgt 
-LEN = ip des Lern-Puffers in 
TASTEn 


Return-kert : keiner 

Info : Wird die ME der Tastenfolge 
nicht vor dem Erreichen des Puffer- 
endes (LEN) durch den Aufruf von 
KbdStopLearn beendet, wird die Auf- 


zeichnung automatisch gestoppt. 
HINEIN NENNEN NENNE DIE BB BRENNEN BB EN 


EZ Ze Ze Ze Ze 2 2 22 22 3 
SEE K 


m KbdLearn( TASTE * lbptr, int len ) 
lernbuf = lbakt = lbptr; /* Adresse des Puffers speichern */ 
lblen = len; /* Länge des Puffers merken */ 


a = TRUE; /* ab jetzt werden die Zeichen aufgezeichnet */ 


Listing 2: (Fortsetzung) 
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MouHideMouse(): Entfernt den Maus-Cursor vom Bild- 
schirm. Siehe auch MouShowMouse( ). 
MouSetMoveArea(): Mit Hilfe dieser Funktion können Sie 
den Bildschirmbereich festlegen, innerhalb dessen sich der 
Maus-Cursor bewegen darf. 

MouSetSpeed(): Diese Funktion erlaubt es Ihnen, die 
Mausgeschwindigkeit, d.h. das Verhältnis zwischen der 
Maus-Bewegung und der Bewegung des Maus-Cursors auf 
dem Bildschirm festzulegen. 

MouBefinePtr(): Mit Hilfe dieser Funktion können Sie das 
aktuelle Erscheinungsbild des Maus-Cursors festlegen. 
MousSetDefaultPtr(): Erlaubt Ihnen, das Erscheinungsbild 
des Maus-Cursors festzulegen, das vom Maus-Handler 
immer dann aktiviert wird, wenn sich die Maus in keinem 
der über MouSetBereich( ) festgelegten Bildschirmberei- 
che befindet. 

MousSetPtr(): Gibt Ihnen die Möglichkeit, den Maus-Cur- 
sor an eine beliebige Bildschirmposition zu bewegen. 
MouPushPara(): Sichert die aktuellen Maus-Parameter auf 
einem internen Stack des KBM-Moduls. Zu den Maus- 
Parametern zählen das Standard-Erscheinungsbild des 
Maus-Cursors, der erlaubte Bewegungsbereich sowie die 
verschiedenen Bildschirmbereiche, die über MouSet- 
Bereich( ) definiert wurden. 

MouPopPara(): Holt die über MouPushPara( ) gesicher- 
ten Maus-Parameter wieder vom Stack und aktiviert sie. 


KbdGetKey(): Liefert die jeweils nächste Taste und entfernt 
sie aus dem internen Tastaturpuffer. 

KbdFlushBuf(): Löscht den internen Tastaturpuffer und 
alle Zeichen, die sich noch im BIOS-Tastaturpuffer befin- 
den. 

KbdClearAllMaks(): Löscht alle über KbdSetMakro( ) 
angelegten Tastaturmakros. 

KbdClearAllFkt(): Löscht alle über KbdSetFkt( ) defi- 
nierten Verknüpfungen zwischen einer Taste und einer 
Funktion. 

KbdSetMakro(): Definiert ein Tastaturmakro. Bei der 
Betätigung der angegebenen Taste wird fortan immer die 
angegebene Tastensequenz in den internen Tastaturpuffer 
gebracht und beim Aufruf der Funktion KbdGetKey() 
Taste für Taste an den Aufrufer übergeben. 
KbdDelMakro(): Löscht ein zuvor über KbdSetMakro( ) 
definiertes Tastaturmakro. 

KbdSetFkt(: Mit Hilfe dieser Funktion können Sie errei- 
chen, daß bei der Betätigung der angegebenen Taste jeweils 
die Funktion aufgerufen wird, deren Adresse Sie KbdSet- 
Fkt( ) übergeben haben. Dadurch wird eine Verknüpfung 
zwischen der Taste und der Funktion hergestellt. 
KbdDelFkt(): Löscht eine zuvor über KbdSetFKt( ) herge- 
stellte Verknüpfung zwischen einer Taste und einer Funk- 
tion. 

KbdLearn(): Diese Funktion startet den sogenannten Lern- 
Modus, in dem alle eingegebenen Tasten in einem Puffer 
des Aufrufers aufgezeichnet werden. 
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KbdStopLearn(): Beendet den Lern-Modus und teilt dem 
Aufrufer mit, wieviele Tasten in dem Puffer aufgezeichnet 
wurden, dessen Adresse der Funktion KbdLearn( ) über- 
geben wurde. 


Das Demoprogramm KBMDEMO.C 


Um Ihnen die Arbeit mit den Funktionen des KBM-Moduls 
auch an einem praktischen Beispiel zu demonstrieren, fin- 
den Sie in Listing 3 das Demo-Programm KBMDEMO!.C. 
Es besteht aus drei kleinen Demos, in denen Ihnen zunächst 
die Arbeit mit den Funktionen zum Zugriff auf die Tastatur 
verdeutlicht wird. Die zweite Demo zeigt dann, wie Sie mit 
Hilfe der Funktionen zur Abfrage der Maus und den ver- 
schiedenen Funktion aus dem VIO-Modul beliebige Bild- 
schirmbereiche markieren können. Die abschließende 
Demo macht deutlich, daß Tastatur und Maus gleichzeitig 
abgefragt werden können und zeigt Ihnen die sinnvolle 
Verwendung verschiedener Mausbereiche. 

Erstellen können Sie das Demo-Programm, indem Sie 
ihren Microsoft C-Compiler (Version 5.1) über den folgen- 
den Befehl starten: 
cl /AS kbmdemo.c kbm.c vio.c 

Beachten Sie bitte, daß das KBM-Modul unter allen Spei- 
chermodellen des Microsoft C Compilers kompiliert wer- 
den kann, in einigen Speichermodellen bei der Kompilie- 
rung jedoch Warnmeldungen ausgegeben werden, mit 
denen der Compiler den Zugriff auf die Prozessorregister 
innerhalb des Maus-Handlers bemängelt. Diese Meldungen 
haben jedoch keinen Einfluß auf die Codegenerierung und 
können deshalb unbeachtet bleiben. 

Michael Tischer 


[RAN NENNE EEE NENNEN EA 
* Funktion :KbdStopLearn 
*%* 
: Beendet die Aufzeichnung der Tasten- 
folgen, die durch den Aufruf von 
KbdLearn initiiert wurde. 
* Eingabe-Parameter: keine 


* Return-Wert : Anzahl der aufgezeichneten Tasten 
EHEN EN DENIED NEE DE BED NE DIEBE DE BEE DIEBE BE DIEBE DIENEN DENE EBENE NENNE NEN NENEIEIEDE HEINE NEN 


en KbdStopLearn( void ) 


lern = FALSE; 
a lbakt - lernbuf; 


/* Eingaben nicht mehr aufzeichnen */ 
/%* Anzahl Tasten zurückliefern */ 


Listing 2: (Ende) 


PRBRRBBBRREBBRBBERBBBRRBRGBBRREGBERSGBDRRSGBGGRREGGRBBRGBGBRGREREE/ 
KBMDEMO.C 


: Demonstriert die Arbeit mit den ver- 
schiedenen Funktionen des KBM-Moduls. 


: MICHAEL TISCHER 
entwickelt am : 29.81.1989 
letztes Update : 2.82.1988 


Erstellung : CL [Modell] KBMDEMO.C KBM.C VIO.C 


JOSE INNEN 


/#*-- Include-Dateien einbinden 


/* für die Funktionen aus VIO.C */ 
/* für die Funktionen aus KBM.C */ 
/* für MIN() und MAX() %/ 


include "vio.h” 
Zinclude "kbm.h” 
include <stdlib.h> 


WHEN NENNE NENNE NN NN NN 


* Funktionen im Zusammenhang mit der DEMO1 * 
EEE NEIN N EEE ID RN EN E/ 


/* im Lern-Modus? %*/ 


BYTE lerne = FALSE, 
/* Umsetzung der Umlaute? */ 


umsetzung = FALSE; 
aa hilfe_demo1() 


static BYTE aktiv = FALSE; 
ai char *helpz[] = 


"Diese Demo soll Ihnen die Arbeit mit Tastaturmakros und", 
”der Verknüpfung von Tasten und Funktionen verdeutlichen.”, 


/* rekursiver Aufruf? */ 


"Sie können beliebige og a ei ce die in dem”, 
Re überdeckten Fenster erscheinen. Beendet wird die”, 
"D mo durch Betätigung der »Return«-Taste.”, 

"Mit Hilfe verschiedener Makros werden die deutschen Um-”, 
"laute in ihre englische Schreibweise 'ae’, ’oe’ etc. um-”, 
"gesetzt. Diese Umsetzung können Sie mit Hilfe der Tas-", 
"tenkombination »Alt U« an- und ausschalten.”, 


"Die Aufzeichnun, B 
"tätigung von »Ctrl L« eingeleitet und bei erneuter Be-”, 
»tätigung dieser Taste wieder abgestellt. Die aufgezeich-", 
"nete Tastenfolge kann dann über die Funktionstaste »Fid«”, 
nabgerufen werden.”, 


beliebiger Tastenfolgen wird durch Be-" 


. Bitte »Return« betätigen” 
BYTE 1 


‚ /* Schleifenzähler 
spalte, zeile; 


/* nimmt Cursor-Spalte und Zeile auf 


/* Funktion bereits aktiv? 

/* Nein 

/* die Help-Funktion ist jetzt aktiv 
/* Cursor-Spalte ermitteln 
/* Cursor-Zeile ermitteln 
/* Fenster öffnen 


2 ( taktiv ) 


aktiv = TRUE; 
spalte = AKTS; 
zeile = AKTZ; 
ViokinOpen( 6, 1, 66, 23 ); 
VioFrame( VL(#), VO(8), VR(#), VU(8), EINRA, INVERS ); 
VioClear( VL(1), VO(1), VR(-1), VU(-1), INVERS ); 


for (i=8; i < ELVEK(helpz); ++1) /%* die Zeilen durchl. 
VioPrint( VL(2), VO(2+i1), INVERS, TRUE, helpz[i] ); 

KbdFlushBuf(); /%* Tastaturpuffer löschen 

while ( KbdGetkey() t= CR ) /* auf RETURN warten 


ViokinClose( TRUE ); /* Fenster wieder schliepen 


VioSetCursor( spalte, zeile ); /* Cursor zuücksetzen 
aa = FALSE; /* die Help-Funktion ist nicht mehr aktiv 


/* Lern-Modus an- ausschalten 


static TASTE buf[189]; 
BYTE tlen; 


/* ninat Tastenfolge auf 
/* Länger der Tastenfolge 


Listing 3: KBMDEMO.C 
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if ( lerne == FALSE ) /* im Lern-Modus? */ VioScrollUp( VL(1), VOo(2), VR(-1), VU(-1), 1, NORMAL ); 
/* Nein, Starte den Lern-Modus */ } 
KbdDelMakro( F1B ); /%* Makro löschen */ while ( key != CR); /* wiederholen bis RETURN betätig */ 
KbdLearn( buf, ELVEK( buf ) ); /* Learn-Modus starten */ if ( lerne ) /* Lern-Modus noch an? */ 
VioPrint( VR(-7), VO(8), INVERS, FALSE, ” LERN ”); lernen(); /* Ja, ausschalten */ 
lerne = TRUE; /* Lern-Nodus ist jetzt an */ if ( umsetzung ) /* Umsetzung der Umlaute noch aktiv? */ 
umlaute(); /* Ja, Umleitung wieder abschalten */ 
else /* Lernmodus anschalten */ KbdDelFkt( ALT U ); /* die Verknüp zwischen den */ 
{ KbdDelFkt( Fi ); /* verschiedenen Tasten und den */ 
tlen = KbdStopLearn(); /%* ee der Tastenfolge erm. %*/ KbdDelFkt( CTRL_L ); /* Funktionen wieder auflösen %*/ 
VioPrint( VR(-7), VO(8), NORMAL —"); KbdFlushBuf(); /* Tastatur-Puffer löschen */ 
KbdSetMakro( Fi, buf, tlen ); /* er auf FIG ®/ VioWinClose( TRUE ); /* Fenster wieder schließen */ 
ie = FALSE; /* Lern-Modus ist jetzt aus */ } 


[Pe EEE NEE NEN NN NENNEN NEE NENNEN NEN NEE 


* Funktionen im Zusammenhang mit der DEMO2 * 
ERHRRRBRBBBBRBEBBIRBRERERERBERBREREIBEBIEIRBIEIBIEIBIHIBIEIRBIEIBEISENEIINE/ 


/ 
a umlaute() 


void demo2( void ) 
/%*-- Makros zur Umsetzung der Umlaute { 
static TASTE umlaut_k aet] = { KEY(’a’), KEY(’ static char *info[] = 
ee u ={ KEYC'A), KEY(’ { 
umlaut k_oe[] = { KEY(’o'), KEY(’ "Innerhalb der umrahmten Fläche können” 
umlaut -E0el} = { KEY(’O’), KEY(’ ” Sie den Maus-Cursor a 
umlaut_k_uel] = { KEY(’u’), KEY(’ "bewegen. Bei fortwährender Betätigung ” 
umlaut_g_uel] = { KEY('U'), KEYC’ "des linken Maus-Knopfes können”, 
umlaut sz2[] = { KEY('s’), KEY(' "sie einen Bildschirmbereich markieren” 
der dabei farblich hervorge-”, 
if ( umsetzung == FALSE ) /* Umsetzung anschalten? */ "hoben wird.” 
{ "Beenden Sie diese Demo durch Niederdrü” 
/*-- die einzelnen Umlaute über die Makros umdefinieren Bed "cken des rechten Mausknopfes.” 
KbdSetMakro( KEY('ä’), umlaut _k_ae, ELVEK( umlaut_k_ae }; 
KbdSetMakro( KEY('Ä’), umlaut g ae, ELVEK( umlaut g ae 5 
KbdSetMakro( KEY(’ö’), umlaut k_oe, ELVEK( umlaut_k_oe : TASTE key = KEY(ß); 
KbdSetMakro( KEY('d*), umlaut g oe, ELVEK( umlaut g oe : BYTE rowi, coli, /* ed a der Maus */ 
KbdSetMakro( KEY(’ü’), umlaut_k ue, ELVEK( umlaut | - row2, col2, uelle Mausposition */ 
KbdSetMakro( KEY('Ü’), umlaut_g ue, ELVEK( umlaut_g ue ) ); newrow, newcol, /* jeweils neue Mausposition */ 
KbdSetMakro( KEY(’p'), umlaut_sz, ELVEK( umlaut sz ) ); deltax, deltay, /* Entfernung vom ur ”/ 
umsetzung = TRUE; /* Umsetzung jetzt an */ % 
} sektor; /* Sektor, in dem sich der Maus-Cursor se er 
else /* Umsetzung ist an, jetzt ausschalten */ int event; /* Bit-Maske für jeweiliges Ereignis */ 
{ /# Hakro- finitionen wieder löschen */ 
KbdDelMakro( KEY(’ä') VioHideCursor(); /* Cursor verstecken */ 
KbdDelMakro( KEY(’Ä') ); VioColor( VL(8), VO(B), hä Vo(4), INVERS ); 
- for (i=8; 1 < ELVEK (Inf 0); ++1) /* die Zeilen durchl. “/ 
KbdDelMakro( KEY(’Ö’) ); VioPrint( VL(5), VO(i), INVERS, TRUE, infoli] ); 
KbdDelMakro( KEY('ü’) ); VioFrame( VL(8), VO(5), VR(8), Vu(@), EINRA, NORMAL ); 
KbdDelMakro( KEY('Ü') Ys MouSetMoveArea( VL(1), VO(6), VR(-1), VU(-1) ); 
KbdDelMakro( KEY(’B') ); MouSetPtr( VCOL >> 1, ((VROW-5) > 1) +5 ); 
umsetzung = FALSE; /* Umsetzung jetzt aus */ MouShowMouse(); /* Maus-Cursor anzeigen %/ 
} while ( TRUE ) /* Endlosschleife */ 


MouSetDefaultPtr( MouPtrMask( PTRSAMECHAR, PTRINVCOL ) ); 


/*-- warten, bis der linke oder der rechte Mausknopf ----#/ 
/*-- niedergedrückt wird Im 
event = KbmEventkait( EV _LEFT PRESS | 

TASTE key; EVURIGHT_PRESS | EV_KEY_AVAIL ); 


BYTE i, 

if ( event & EV_KEY_AVAIL ) /* Taste betätigt? */ 
umlaute(); /* Unsetzung der Umlaute anschalten %*/ { /* Ja, wurde ESCAPE betätigt? */ 
KbdSetFfkt( ALT_U, umlaute); /*Umsch. der Umlaute über ALT_Ur/ if ( (key = KbdGetKey()) == ESC ) 
KbdSetFkt( Fi, hilfe demo! ); /* Fi liefert Infos */ break; /* Ja, Demo beenden */ 


KbdSetFkt( CTRL ‚L, lernen ); /*CTRL_L = Tastensequenz aufz.*/ } 
if ( event & EV_LEFT_PRESS ) /*linke Maustaste betätigt? */ 
VioWinOpen( VL(ß), vor), VL(28), VU(8) ); { /* Ja %/ 
VioClear( VL(1), VO(1), VR(- U; Vu(- 1), NORMAL ); MouSetDefaultPtr (MouPtrMask( PTRSAMECHAR, PTRSAMECOL )); 
VioFrame( VL(#), VO(ß), VR(8), VU(ß), DOPRA, NORMAL ); row! = row2 = MouGetRow(); /* aktuelle Mauszeile und = 
VioPrint( VL(2), vu(ß). INVERS, FALSE, "Fi = Hilfe ” ); coll = col2 = MouGetCol(); /* -spalte merken 
VioSetCursor( VL(2), VU(-1) ); deltax = deltay = sektor = ß; 
do MouHideMouse(); "/* Maus-Cursor ausblenden #*/ 
{ VioPrint( coll, rowi, INVERS, FALSE, ” ” ); 
key = KbdGetKey(); /# Taste holen */ MouShowfouse(); /* Maus-Cursor wieder einblenden */ 
if ( IsAKey( key ) ) /* ASCII-Zeichen? %*/ while( TRUE ) /* Endlosschleife */ 
VioPrintf( VL(2), Vu(-1), NORMAL, FALSE, "%c”, key ); { 
else /* erweiterten Tastaturcode empfangen “/ /#-- warten bis die Maus bewegt oder der linke 
VHoPrInt£( VL(2), VU(-1), NORMAL, FALSE, /#*-- Mausknopf wieder losgelassen wird 
"EXTENDED: 134”, key ); event = KbmEventkait( EV_MOU_MOVE | EV_LEFT_REL ); 


Listing 3: (Fortsetzung) Listing 3: (Fortsetzung) 
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/* Maus bewegt? */ 
/* Ja */ 
/* aktuelle Position des */ 
newcol = MouGetCol(); /* Maus-Cursors ermitteln */ 
MouHideMouse(); /* Maus-Cursor wegblenden */ 
if ( sektor t= ( i = (mewcol>col1? 1:8) + 
(newrow>row1? 2:8))) 
{ /* neuer Sektor */ 
VioColor(min(coll, col2), min(rowi, row2), 
max(coli, col2), max(rowi, row2), NORMAL); 
col2 = newcol; /* neue Position updaten ”/ 
row2 = newrow; 
VioColor(min(coll, col2), min(rowi, row2), 
max(coll, col2), max(rowi, row2), INVERS); 
sektor = 1; /* neuen Sektor merken */ 
deltax = abs( newcol - coll ); /* Entfernung vom */ 
deltay = abs( newrow - row! ); /* Ursprung ber. */ 


" ( event & EV_MOU_MOVE ) 


newrow = MouGetRow(); 


else /* kein neuer Sektor */ 
if ( newcol != col2 ) /* neue Spalte? */ 
/* Ja */ 
/#*-- gehören I mehr Spalten zum Bereich? --*/ 
if (deltax < (i=abs(newcol-col1l))) 
VioColor( (newcol < col2) ? newcol : col2+1, 
min(rowi, row2), 
(newcol > col2) ? newcol : col2-1, 
max(rowi, row2), INVERS ); 
else /* weniger m. im markierten Bereich */ 
VioColor( (newcol < col2) ? newcol+1 : col2, 
min(rowi, row2), 
(newcol > col2) ? newcol- ! : col2, 
max(rowi, row2), 
/* neue Anzahl Spalten merken */ 


/* neue Zeile? */ 
/* Ja */ 
an geboren jetzt mehr Zeilen zum Bereich? ---*/ 
if ( deltay < (i=abs(newrow-row1)) ) 
VioColor( min(col1, newcol), 
(newrow € row2) ? newrow : row2+1, 
max(coll, newcol), 
(newrow > row2) ? newrow : row2-1, 
INVERS ); 
else 7% weniger Zeilen im Bereich */ 
VioColor( min(coli, newcol), 
(newrow < row2) ? newrow+l : row2, 
max(coli, newcol), 
(newrow > row2) ? newrow-1 : row2, 


); 
/* neue Anzahl Zeilen merken */ 


deltax = 1; 


gr ( newrow != row2 ) 


tele -j; 
col2 = newcol; /* neue Position merken */ 
row2 = newrow; 


a /* Maus-Cursor wieder einblenden */ 


else /* linker Mausknopf wurde losgelassen */ 


MouHideMouse(); /* Maus-Cursor ausblenden */ 
VioColor(min(coll, col2), min(rowi, row2), 

max(coli, col2), max(rowi, row2), NORMAL); 
MouShowMouse(); /#* Maus-Cursor wieder einblenden */ 
N /* aus der Schleife ausbrechen #/ 


} 
} 
else /* der rechte Mausknopf wurde betätigt */ 
break; /* aus der Endlosschleife ausbrechen */ 


if ( key 1= ESC ) /* wurde die Demo über ESCAPE beendet? */ 
/*-- Nein, über den rechten Maus-Knopf ------------------#/ 
KbmEventkait( EV_RIGHT_REL ); /%* auf Loslassen warten */ 
MouHideMouse(); /* Maus-Cursor ausblenden %*/ 
VioClearScreen( NORMAL ) /* den Bildschirm löschen */ 
EN: Rlöngagstreibeit wieder herstellen*/ 
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/ EEE DENE EEE NEE EN BREENEENENNNEENENEEEENEEE 
* Funktionen im Zusammenhang mit der DEMO3 * 
HEHE NENNE EEE NEN NENNE EEE NEE NENNE NEE DENE NEN NENNE NEE NENNE IE EEE EDEN EEE ICE, / 


ne hilfe() 
rn char *hz[] = 


"Bewegen Sie den Zeichenblock mit Hilfe der Cursor-", 
"Tasten oder indem Sie den Maus-Cursor in den Bild-", 
"schirmrahmen bewegen und dann den linken Mausknopf", 
"niederdrücken.”, 


"Beenden Sie die Demo nit Hilfe des rechten Maus-", 
"knopfes.", 


}; 
BEREICH bereich; 
BYTE i, /* Schleifenzähler 
spalte, /#* aktuelle Mausposition 
zeile; 


spalte = MouGetAktCol(); 
zeile = MouGetAktRow(); 


/* aktuelle Mausspalte holen 
/* aktuelle Mauszeile holen 

MouPushPara(); /* Mausparameter sichern 

ViokinOpen( 15, 5, 69, /* Fenster öffnen 

VioFrame( VL(B), vo(ß), \rıbı, Vu(8), DOPRA, INVERS ); 

VioClear( VL(1), VO(1), VR(- 1), Vu(- ı), INVERS ); 

for (i=B; 1 < ELVEK(hz); +1) /%* die Zeilen durchl. 
VioPrint( VL(2), VO(2+1), INVERS, FALSE, hzli] ); 

MouSetMoveArea( vLct), Vo(1), VR(- 1), Vu(-1) ); 

MouSetDefaultPtr( MouPtrMask (PTRSAMECHAR, PTRINVCOL) ); 

bereich.xi = VR(-15); /* Position des OK-Felds setzen 

bereich.yl = VU(-4); 

bereich.x2 = VR(-3); 

bereich.y2 = VU(-2); 

bereich.ptr_mask = MouPtrMask( PTRDIFCHAR( 251 ), 


PTRDIFCOLB( 28x78 ) ); 
MouSetBereich( 1, &bereich ); /* das OK-Feld definieren 
MouSetPtr( VL(4), VU(-2) ); /* Maus-Cursor setzen 
MouShowMouse(); /* Maus-Cursor wieder einblenden 
/* auf Denn Se des linken Mausknopfs warten 
S: 


do { 
ZIRSERONEN EV_LEFT_P! 


while ( MouGetBereich() != 8 ); /* warten bis Maus im OK-F. 
KbmEventkait( EV_LEFT_REL ); 
MouHideMouse(); 
VioWinClose( TRUE ); 
ae ee 

Ptr( spalte, zeile ); 


/* Maus-Cursor wegblenden 

/* Fenster wieder schließen 
/* Mausparameter zurückholen 
/* Maus zurück an alte Pos. 


/ 
void demo3( void ) 
static BEREICH bereiche[5] = 


{B, 8. 2. ‚ MouPtrMask(PTRDIFCHAR(2x18), PTRINVCOLB) 
{8, 25" MouPtrMask(PTRDIFCHAR(Sx1b), PTRINVCOLB) 
{B, a, Pag, 24, MouPtrMask (PTRDIFCHAR(8x19), PTRINVCOLB) 
79, 1 ‚79, 23, MouPtrMask(PTRDIFCHAR(x1a), PTRINVCOLB) 
(5, 24, 11, 24, MouPtrMask(PTRSAMECHAR, PTRINVCOL) 


TASTE key; 
int ev, /* Bit-Maske des jeweiligen Events */ 
richtung; /* Richtung, in der gescrollt werden soll */ 
BYTE spalte = (VCOL >> 1) - 2, 
sg = (VROW >> 1) - 2, 
rn; /* TRUE, wenn die Maus sich im Rahmen befindet */ 
if ( VobLt=as H VROKt=25 ) /* nicht im 88%*25 Bildschira? */ 
{ /* nein, Koordinaten in BEREICHE laden */ 
bereiche[8].x2 = bereichel2].x2 = 
bereiche[3].x1 = bereiche[3].x2 = VR(B); 
bereiche[2].y! = bereiche[2].y2 = 
bereiche[4].yi = bereiche[4].y2 = wen: 
rosa .y2 = bereiche[3].y2 = VU(-1); 


Listing 3: (Fortsetzung) 
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SAA-Benutzeroberfläche in C 


MouSetDefaultPtr( MouPtrMask( PTRSAMECHAR, PTRINVCOL ) ); 
VioHideCursor (); /* blinkenden Cursor ausblenden #/ 
VioClearScreen( NORMAL ); /% Daun, löschen */ 
VioFrame( VL(8), VO(#), VR(#), VU(®), DOPRA, NORMAL ); 
VioPrint( VL(4), VU(B), NORMAL, FALSE, "1 Pd; 

VioPrint( VL(5), VU(8), INVERS, FALSE, ” HILFE ”); 

VioFill( spalte, zeile, spalte+4, zeile+4, ’a’, NORMAL ); 
MouShowMouse(); /# Mada-Curdor anzeigen */ 
MouSetBereich( 5, bereiche ); /* 4 Mausbereiche anlegen */ 
ms ( TRUE ) /* Endlosschleife */ 


ev = KbmEventWait( EV RIGHT PRESS | 
at PRESS | 
VKEY AVAIL ); 
if ( ev & EV_RIGHT_ PRESS ) /*rechter Mausknopf gedrückt?*/ 
break; /* Ja, die Schleife beenden */ 


if ( ev & EV KEY AVAIL ) /* Taste betätigt? */ 
{ /* Ja, testen ob Demo durch ESCAPE beendet wird */ 
if ( (key = KbdGetKey()) == ESC ) 
break; /* Ja, Demo beenden */ 
ie ( key ) /* Taste auswerten */ 


case CP: richtung = /* Cursor Up */ 
case CLEFT : richtung = ]; /* Cursor Left */ 
case CDOWN : richtung = 2; break; /* Cursor Down %*/ 
case CRIGHT : richtung = 3; break; /#* Cursor Right */ 
N » richtung = KEIN _| BEREICH; 


} 
else /* linker Maus-Knopf niedergedrückt */ 
richtung = MouGetBereich(); /* Maus-Bereich holen %/ 
a ( richtung t= KEIN_BEREICH ) /# abs ? 2) 
“ Ja # 
if ( MouGetAktBer() == KEIN BEREICH ) /* akt. Bereich */ 
{ nn Maus ist innerhalb des Bildschirn-Rahmens */ 
ir = TR 


„fouiidefluset); /* Maus-Cursor ausblenden %/ 


switch ( richtung ) /* die Richtung bestimmt den Code #/ 
{ /* nicht das Bewuptseint? #/ 
case 8 : if ( zeile != VO(1) ) 
{ /* nocht nicht in erster Zeile */ 
VioScrollUp( sth vu VR(-1), 
Vu(- 1), 1 ’ NORMAL ); 
--zeile; 


break; 


Listing 3: (Fortsetzung) 


: if ( spalte != VL(1) ) 
{ /* noch nicht in erster Spalte */ 
VioScrollLeft( VL(2), VO(1), VR(-1), 
Vu(-1), 1, NORMAL ); 


--spalte; 
} 


break; 
: if ( zeile+4 != VU(-1) ) 
{ /* noch nicht in letzter Zeile */ 
VioScrollDown( VL(1), VO(1), VR(-1), 
VuU(-2), 1, NORMAL ); 
++zeile; 


reak; 
ir ( spalte+4 t= VR(-1) ) 
{ /* noch nicht in letzter Spalte */ 
VioScrollRight( VL(1), Vo(1), VR(-2), 
vuc-1), % NORMAL ); 
ER 


break; 
age 4 : hilfe(); /* Hilfsfunktion aufrufen */ 


It.T-Ar /* war Maus im Rahmen? */ 
MouShowMouse(); /* Ja, Maus-Cursor wieder anzeigen */ 


} 
N /* Maus-Cursor ausblenden %#/ 


[MEERE NENNEN 


* HAUPTPROGRAMM * 
BEISEESTTEETTEEET TEE STETTEN 7777777777777207777777777777 


Ps: nain() 
Violnit(); /* Vio-Modul initialisieren 
KbnInit(); /* Kbm-Modul initialisieren 
VioClearScreen( NORMAL ); /* den Bildschirm löschen 
demo1(); /* die verschiedenen Demos ausführen 
a ( MouAvail() ) /* ist eine Maus.installiert? 


/* Ja 
demo2(); /* die Mausdemos ausführen 
mat 


VioGlearScreen( NORMAL ) 
Ray wei: 8,8); 


/* den Bildschirm löschen 
/* Cursor in obere linke B.Ecke 


Listing 3: (Ende) 


Greifen Sie für uns zur Feder! 


Wir suchen schreibfreudige Experten. 


Wenn Sie Ihr Wissen über Programmierung oder über Standard-Anwendungen nicht für sich be- 
halten und daraus Kapital schlagen wollen, wenden Sie sich an uns. Wir suchen ständig Autoren 
für das Microsoft System Journal und mehrere Buchreihen renommierter deutscher Fachverlage. 


Redaktionsbüro Hartmut Niemeier, 
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Grundlagen der Farbmischung: 


Der Einsatz von Farbe im Raster-Video-Modell 


In den letzten Jahren fand eine dramatische 
Revolution in der Computergrafik statt. Als ich 
begann, am Computer zu arbeiten, war ich mit 
einem kleinen Monochrom-Monitor ohne Gra- 
fikmöglichkeiten mit 80 Zeichen und 25 Zeilen 
zufrieden. Heute fühle ich mich schon bei einer 
Auflösung von weniger als 640 x 480 Pixel einge- 
schränkt. Heutzutage sind Bildschirme mit einer 
Auflösung von 1280 x 900 keine Seltenheit und 
einige haben eine noch höhere Auflösung. Früher 
gaben wir uns mit monochromer Ausgabe zu- 
frieden. Nunmehr erwarten wir zumindest 8 oder 
16 Farben, selbst vom einfachsten Bildschirm- 
system. 


Die Einführung von Farbgrafik auf Personalcomputern 
hatte einen tiefgreifenden Einfluß auf die Software-Ent- 
wicklung. Desktop-Publishing-Systeme, Programme für Prä- 
sentationsgrafiken, Zeichenprogramme und Bildverarbei- 
tungstools wurden teilweise durch diese Technologie erst 
ermöglicht. Trotz dieser Fortschritte nehmen wir noch 
immer die Möglichkeiten der Farbverarbeitung auf dem 
Computer als gegeben hin. Wie eine Analyse zeigt, sind 
selbst die besten heutigen Bildsysteme noch weit von der 
Wirklichkeit entfernt. 


Farbzusammensetzung 


Farbempfinden ist sehr subjektiv und hängt ganz von unse- 
ren Wahrnehmungen ab. Die Farbe, die wir sehen, setzt 
sich aus den physikalischen Eigenschaften des jeweiligen 
Objekts, den Lichtquellen, die dieses Objekt beleuchten und 
den physiologischen und wahrnehmungsbedingten Eigen- 
schaften des menschlichen Auges zusammen. 

Der Prozeß der Wahrnehmung ist sehr komplex und 
keine einzige physikalische Theorie hat bis jetzt auch nur 
die einfachste Beobachtung zufriedenstellend erklären kön- 
nen. Beispielweise bemerken wir, vom physikalischen 
Standpunkt aus gesehen, subtilste Unterschiede in der 
Intensität von Farben; die Fähigkeit, kleine Differenzen in 
der Färbung oder von einer Farbe zur anderen zu erkennen, 
variiert jedoch stark. Tatsächlich erscheinen viele Energie- 
niveaus des Lichtes, praktisch gesehen, gleich. Der Mensch 
versucht seit Jahrhunderten, diese physikalischen Beobach- 
tungen zu deuten und mit unserem Farbempfinden in Ein- 
klang zu bringen. Zwei generelle Beschreibungsmethoden 
sind aus diesen Forschungen hervorgegangen. 

Die erste Methode ist die von Künstlern verwendete: 
Einfärbungen, Schattierungen und Farbtöne (siehe Bild 1). 
Dieses subtraktive Modell ergibt sich aus der Art, in der ein 
Künstler ein Bild auf weißes Papier malt. Farbschichten 
werden solange aufeinander gelegt, bis der gewünschte 
Effekt erzielt ist. Weiß wird einfach durch Weglassen aller 


Bild 1: Einfärbungen (tints), Schattierungen (shades) und 
Farbtöne (tones). 


Pigmente, Schwarz durch Kombination aller Pigmente 
erzielt. Eine Einfärbung wird durch Verminderung der Sät- 
tigung einer Grundfarbe erreicht oder, anders gesagt, durch 
Mischen mit Weiß. Schattierungen kommen dadurch 
zustande, daß man eine Grundfarbe mit Schwarz mischt, 
d.h. ihre Helligkeit reduziert. Der Farbton schließlich resul- 
tiert aus der Mischung einer Grundfarbe sowohl mit Weiß, 
als auch mit Schwarz. Die Kombination dieser Verfahren 
produziert verschiedene Farben derselben Farbabtönung in 
unterschiedlichen Helligkeits- und Sättigungsgraden. 

Bei der zweiten Methode geht es um Farbabtönung, 
Sättigung und Helligkeit. Von einem beschreibenden 
Standpunkt fügt dies eine weitere Dimension zu der tradi- 
tionellen Einfärbungs-, Schattierung- und Farbton- 
Beschreibungsmethode, wie von Künstlern verwendet, 
hinzu. Die Farbabtönung bezeichnet die Farbmenge einer 
bestimmten Farbe wie Rot, Grün oder Blau. Die Sättigung 
ist insofern schwieriger, als sie sich auf die Reinheit der 
Farbe bezieht, d.h., wie stark sie erscheint. Mischt man bei- 
spielsweise reines rotes Licht mit weißem erhält man Rosa. 
Dieses Rosa ist wie Rot, nur weniger gesättigt. Die Hellig- 
keit schließlich bezieht sich auf die physikalische Intensität 
oder Leuchtkraft der Farbe und ist unabhängig von der 
tatsächlichen Farbabtönung und Sättigung. 

Mathematisch gesehen sind beide Modelle bei der 
Beschreibung von verschiedenen Farben schwer zu behan- 
deln. Oft ist das beste Mittel zur Messung einer unbekann- 
ten Farbe der Vergleich mit einer Mustersammlung, wie die 
Farbtafeln, die man beim Kauf einer Lackdose verwendet. 

Eine objektivere Methode beim Farbvergleich ist die 
Klassifizierung der Wahrnehmung (normalerweise sicht- 
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MAGENTA 


Bild 2: Ein RGB-Farbwürfel (hier als Drahtmodell dargestellt, 
damit Farben von allen Seiten gezeigt werden können). 


bares Licht) nach Hauptwellenlänge, Reinheit und Leucht- 
stärke. Die daraus resultierende spektrale Energieverteilung 
ergibt dann die »Farbe«. Der Ausdruck Hauptwellenlänge 
ergibt sich aus der Tatsache, daß unser Auge beim Betrach- 
ten eines Objekts auf eine spezifische Wellenlänge stärker 
als auf andere reagiert. Diese bestimmt die Farbe, die wir 
sehen. Reinheit bezieht sich auf die mathematische Kombi- 
nierung von farblichem und weißem Licht. Eine vollständig 
reine Farbe enthält kein weißes Licht und wird daher oft als 
100 Prozent gesättigt bezeichnet. Leuchtstärke bezieht sich 
auf die Gesamtenergie einer bestimmten Farbe. Dies bein- 
haltet sowohl die Reinheit als auch die Hauptwellenlänge 
des zu betrachtenden Lichts - je mehr Energie, desto sicht- 
barer die bestimmte Farbe. 


Farb-Mischmodelle 


Von der physiologischen Seite her wird theoretisiert, daß 
die Retina des menschlichen Auges drei Arten von Zäpf- 
chen enthält, empfindlich für Rot, Grün und Blau. Diese 
Hypothese wurde, trotz anderer neuer Sehtheorien, auf das 
Gebiet der Computergrafik angewendet. Die meisten Farb- 
monitore verwenden rotes, grünes und blaues Phosphor 
beim Versuch, das menschliche Auge zu simulieren. 

Die Anwendung der Rot-Grün-Blau-Theorie bei Farb- 
monitoren und anderen Hardware-Systemen hat beträcht- 
liches Interesse für die Entwicklung von Modellen ausge- 
löst, die sich diese praktische Spezifizierung von Farbe 
zunutze machen. Die daraus resultierenden Modelle beein- 
flussen unsere Annahme, wie diese Systeme Farbe verwen- 
den. Obgleich sich bestimmte Methoden in einem Fall 
bewähren, in anderen nicht, können sie alle als gleichwertig 
angesehen werden, da dieselben Resultate damit erzielt 
werden können (mit verschiedenen Schwierigkeitgraden). 
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Windows Color Pale 


ette 
Color Mixing Model Sample 
® Red, Green, Blue. RED 255 
O Cyan, Magenta, Yellow. | GREEN 255 
O Hue, Saturation, Value. BLUE ® 


Color Mixture 


Bild 3: PALETTE wird zum Mischen von Grundfarben ver- 
wendet. 


RGB-Mischmodelle 


Das Rot-Grün-Blau-Mischmodell (RGB) ist hardwareori- 
entiert und eine einfache Erweiterung der physikalischen 
Eigenschaften von Farbmonitoren (siehe Bild 2). In diesem 
Modell sind die drei Hauptfarben in einem kartesischen 
Koordinatensystem kombiniert. Das Ergebnis dieser 
Mischung kann sich von den verwendeten Primärfarben 
stark unterscheiden. Zum Beispiel ist Schwarz das Fehlen 
jeglicher Farbe (dargestellt als der RGB-Dreifachwert 0-0- 
0), und die 100-prozentige Mischung aller Farben ergibt 
Weiß (1-1-1). Die Mischung zweier Primärfarben erzeugt 
eine sekundäre Farbmischung. Dies sieht man bei der 
Erzeugung von Gelb (1-1-0) durch Mischen von reinem Rot 
(1-0-0) und reinem Grün (0-1-0). 

Man beachte, daß im RGB-Modell jede Hauptfarbe im 
Bereich (0,1) liegt. In den meisten tatsächlichen Anwen- 
dungen, die auf diesem Modell beruhen, wird eine diskrete 
Umsetzung aus diesem Bereich durchgeführt. Microsoft 
Windows beispielsweise unterstützt über das Graphic 
Device Interface (GDI) nur Farben im Integerbereich 
(0,255). 

PALETTE, ein Windows-Farbmischprogramm, das im 
folgenden Artikel beschrieben wird, unterstützt das RGB- 
Mischmodell, indem es die ausgewählte Farbe in ein ad- 
äquates, von GDI verwendetes Bildschirm-Format umwan- 
delt. Dies geschieht mit den beiden folgenden einfachen 
Formeln: 


crtValue = 
rgbValue = 


rgbValue * 255 
ertValue / 255 


Mit PALETTE kann man einfach mit verschiedenen 
Mengen der Hauptfarben experimentieren. In Bild 3 sieht 


Bild 4: Ein CMY-Farbwürfel (hier als Drahtmodell darge- 
stellt, damit Farben von allen Seiten gezeigt werden können). 


man, daß die Kombination von reinem Rot und reinem 
Grün reines Gelb ergibt, immer vorausgesetzt, Sie besitzen 
einen Farbbildschirm. Wenn Sie weitersuchen, finden Sie 
vielleicht noch einige andere reine Farben, die nicht in den 
Ecken des RGB-Farbwürfels auftreten. Versucht man das- 
selbe Experiment mit anderen Bildschirmsystemen, erhält 
man wahrscheinlich jeweils verschiedene Ergebnisse. 

Wenn Sie einen Monochrom-Monitor verwenden, wer- 
den die Farben hoffentlich als jeweils verschiedene 
Schwarz-Weiß-Mischungen erscheinen. In einem Farb- 
system hängt die Anzahl der möglichen reinen Farben von 
den jeweiligen Eigenschaften der Hardware und des ver- 
wendeten GDI-Bildschirmtreibers ab. Einige Treiber sind 
sehr gut bei der Annäherung von Farben, die zwischen 
Hauptfarben liegen. Andere hingegen verwenden die 
nächstliegende Hauptfarbe. 

Beim Experimentieren werden Sie feststellen, daß die 
Rot-, Grün- und Blau-Spektren, für sich selber wiederum 
nur Muster aus dem RGB-Würfel darstellen. Diese Muster 
wurden durch einen einfachen Algorithmus erzeugt, der die 
Ecken des RGB-Farbwürfels umläuft: 


for ( i=®, i<16, i++) 
{ 
rgbValue = i / 15.00; 
certValue = rgValue * 255; 
} 


Sie können Ihre eigene Mischtabelle durch Einsetzen 
eines anderen Algorithmus erzeugen. 


Das CMY-Mischmodell 


Das Cyan-Magenta-Gelb-Mischmodell (CMY), das Haupt- 
farben subtrahiert, anstelle zu addieren, ist eine Variation 


des RGB-Modells. Anders gesagt, der gewünschte Effekt 
wird dadurch erzielt, daß Farben vom weißen Licht abge- 
zogen werden. Sind alle Farben vertreten, ergibt sich Weiß, 
ist keine vorhanden, Schwarz. Es ist sehr wichtig, das CMY- 
Modell zu verstehen, da es von vielen Hardcopy-Ausgabe- 
geräten verwendet wird. Die Idee, Farbe oder Farbstoff auf 
weißes Papier aufzutragen, wird bei Plottern, Tintenstrahl- 
und Laserdruckern verwendet. 

Mathematisch kann das CMY-Modell durch Einsatz 
eines Kartesischen Farbwürfels erklärt werden (siehe 
Bild 4). Das resultierende Sub-Koordinatensystem ist mit 
dem RGB-Würfel identisch, mit der Ausnahme, daß Weiß 
anstelle von Schwarz im Ursprung liegt. Beim Anblick des 
CMY-Würfels erkennt man, daß eine der Diagonalen vom 
schwarzen zum weißen Eckpunkt verläuft. Farb-Triple ent- 
lang dieser Linie ergeben verschiedene Grau-Mischungen. 
Mit PALETTE kann man sowohl im RGB- als auch im 
CMY-Modell Grauwerte dadurch erzielen, daß für jede der 
Hauptfarben der gleiche Intensitätswert verwendet wird. 

Mit PALETTE werden Sie noch etwas anderes über die 
RGB- und CMY-Mischmodelle feststellen: Ein Grauwert 
wird immer dann erzielt, wenn eine Farbmischung alle 
Hauptfarben beinhaltet. Angenommen, sie haben beispiels- 
weise eine Mischung aus gleicher Menge Cyan und 
Magenta, die einen Blauton ergibt. Fügen Sie nun fortlau- 
fend Gelb dazu (bis zum gleichen Grad wie die anderen 
beiden Farben) verblaßt das Blau immer mehr zu Grau. 
Leider ist dies schwieriger, wenn man mit einer Einfärbung 
beginnt, die ungleiche Mengen von Cyan und Magenta ent- 
hält. Glücklicherweise stehen das RGB- und CMY-Modell 
in einem einfachen Verhältnis zueinander: 


Cyan = 1-Rot 
Magenta = 1-Grün 
Gelb = 1-Blau 


Mit dieser Relation kann man einfach eine Transforma- 
tion erzeugen, die jeden beliebigen CMY-Wert in einen 
RGB-Wert umwandelt und umgekehrt. 


Das YIQ-Modell 


Das YIO-Modell kann, ebenso wie das RGB- und CMY- 
Modell, durch einen Kartesischen Koordinatenwürfel 
beschrieben werden. Dieses Modell ist insofern interessant, 
als es eine Recodierung des RGB-Modells darstellt, opti- 
miert für Übertragungseffektivität und Abwärts-Kompatibi- 
lität mit monochromen Subsystemen, wie beispielsweise 
Schwarz-Weiß-Fernsehern. 

Die Y-Komponente dieses Modells stellt eine Grund- 
farbe dar, deren spektrale Energieverteilung der Hellig- 
keits-Kurve entspricht, wobei die Y-Komponente äquivalent 
zur definierten Farbe ist. Dadurch wird ein wichtiges Pro- 
blem des Fernsehens gelöst, nämlich der Empfang dessel- 
ben Signals von Farb-, als auch Schwarz-Weiß-Geräten. Im 
RGB-Modell können zwei verschiedene Schattierungen auf 
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Y = (0,30*Rot)+(98,59*Grün)+(9,11*Blau) 
I = (8,60*Rot)+(-0,28*Grün)+(-9,32*Blau) 
Q = (8,21*Rot)+(-8,52*Grün)+(90,31*Blau) 


Tabelle 1: Diese Formel berechnet das YIQ-Äquivalent zu 
RGB-Werten. 


einem Farbfernseher die gleiche Helligkeit bei einem 
Schwarz-Weiß-Gerät ergeben. Im YIQ-Modell ist dieses 
Problem durch Umsetzung der unterschiedlichen Farben 
auf entsprechend unterschiedliche Intensitätsgrade gelöst. 

Obwohl in PALETTE das YIQ-Mischmodell nicht 
implementiert ist (das ist einfach zu bewerkstelligen, falls 
Sie dies einmal wollen) kann man das entsprechende YIQ- 
Äquivalent zu einem RGB-Farbwert sehr leicht mittels der 
Formel aus Tabelle 1 berechnen. 


HSV-Mischmodell 


Das HSV-Mischmodell ist im Gegensatz zu den drei vorhe- 
rigen hardwareorientierten Modellen ein Anwendermodell, 
basierend auf der Auffassung der Künstler von Farbgebung, 
Sättigung und Wert. Dieses Modell hat einige deutliche 
Vorteile gegenüber den anderen. 

Topologisch betrachtet ist das HSV-Modell ein Hexa- 
kegel, ein auf den Kopf gestellter, sechsseitiger Kegel 
(Bild 5). Der Fuß dieses Kegels entspricht V=0 und stellt 
Schwarz dar. Das obere Ende des Kegels stellt Weiß mit 
V=1 dar. Jeder der Scheitelpunkte stellt eine Primärfarbe 
oder sekundäre Farbe dar und entspricht einem H-Wert. 
Rot beispielweise entspricht einer Farbabtönung von 0 
Grad, Gelb 60 Grad und so weiter. Die verbleibende Kom- 
ponente Sättigung ist ein Vektor, der horizontal vom 
Ursprung ausgeht. Solange S den Wert O0 beibehält, ist die 
definierte Farbe immer ein Grauwert, der von Schwarz bis 
Weiß reichen kann. Ist S größer als Null, liegt ein 
bestimmter Farbton vor. Dieser Farbton wird immer gesät- 
tigter bis S=1. Jede Farbe, die man bei S=1 und V=1 er- 
hält, entspricht einer Pigmentfarbe, wie sie Künstler benut- 
zen. 

Läßt man die Sättigung konstant, angenommen gleich 1, 
erhält man alle primären und sekundären Einfärbungen, 
indem man die Farbabtönungen von 0 bis 360 Grad durch- 
läuft. Ist eine bestimmte Farbe gefunden, kann man diese 
leicht durch fortwährendes Reduzieren der Sättigung auf 
Null, zu Weiß, ausbleichen. Ebenso kann jede Einfärbung 
durch Reduzieren von V zu Schwarz abgeblendet werden. 

Beim Experimentieren mit PALETTE und dem HSV- 
Modell sieht man bald, wie intuitiv diese Methode ist. So 
sind einige der relativ einfach erhaltenen Farbmischungen 
nur schwer mit einem der anderen Modelle zu erreichen. 

Das mitgelieferte voreingestellte Spektrum für dieses 
Modell ergab sich aus einer Auswahl verschiedener Pfade 
durch den Hexakegel. 
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Value Axis 


Green-120 


Yellow-60 Hue (in degrees) 


Black-0.00 


Bild 5: Ein HSV-Hexakegel (hier als Drahtmodell dargestellt, 
damit Farben von allen Seiten gezeigt werden können). 


Das Standard-Farbabtönungs-Spektrum wurde berech- 
net, indem S=1 und V=1 konstant gehalten wurden und H 
die Werte von 0 bis 360 Grad durchlief. Man beachte dabei, 
daß 0 und 360 äquivalent sind - hat man einmal die vollen 
360 Grad durchlaufen, kehrt man wieder zum Startpunkt 
zurück. Der höchste Wert, den man mit PALETTE auf 
einer linearen Skala erreichen kann, ist 340. Der nächste 
Schritt führt zurück auf 0 (bzw. 360). Das Sättigungs-Spek- 
trum wurde berechnet mit H=240 (Blau) und V=1. In 
diesem Fall werden mehrere $S-Werte verwendet, die von 0 
bis 1 reichen. Das voreingestellte Wertespektrum schließ- 
lich wurde bestimmt, indem V schrittweise von O0 bis 1 
erhöht wird, bei konstanten S=0 und H=0. 

Ein interessanter Aspekt der HSV-Methode ist seine 
Beziehung zum RGB-Modell. Betrachtet man den RGB- 
Farbwürfel entlang seiner Hauptdiagonalen, wirkt er wie 
ein Schnitt durch den Hexakegel bei konstantem -V. Jede 
Schnittebene bei konstantem V entspricht dabei einem Sub- 
Würfel im RGB-Würfel (Bild 6). 


Windows PALETTE 


Im nachfolgenden Artikel werden Sie bemerken, daß am 
Ende der Module PALETTE.C mehrere Farbkonvertie- 
rungsroutinen stehen, die PALETTE zum Arbeiten mit 
dem jeweiligen Mischmodell verwendet. Sobald Sie eine 
neue Farbe definieren, konvertiert das Programm diese 
automatisch in eine äquivalente Darstellung in einem der 
anderen Modelle. Ebenso sucht PALETTE, wenn Sie ein 
neues Mischmodell auswählen (mit den Optionsfeldern), 
darin nach dem besten Gegenstück der aktuellen Farbe. 


YELLOW 


MAGENTA 


Bild 6: Der RGB Sub-Würfel. 


Dieser mathematische Interpolation- und Suchvorgang 
ist etwas ungenau. Er gibt Ihnen jedoch trotzdem eine gute 
Vorstellung davon, wie man eine ähnliche Farbe in einem 
anderen Modell erzeugt. Obgleich in den meisten Fällen 
das jeweilige Gegenstück genau gleich ist, kann doch die 
quantenmäßige Natur der Spektralsteuerung zu einigen 
Inkonsistenzen führen. 

Die Routinen, die diese Farbkonvertierungen in 
PALETTE.C durchführen, sind in Tabelle 2 aufgelistet. In 
diesem Artikel haben wir alle entsprechenden Algorithmen 
aufgezeigt, ausgenommen jenen für das HSV-Modell. Die- 
ser ist etwas komplizierter (mathematisch eine Art topolo- 
gische Windung) und wird besser einer anderen Erläute- 
rung überlassen. Sollten Sie näher daran interessiert sein, ist 


Inserentenverzeichnis 


BKS-Software 13 
Creative Datensysteme 9% 
69, 79 

2 

109, 115 

Kickstein Software 9% 
Markt & Technik Buchverlag 80/81, 116 
12/13, 104/105 


te-wi Verlag 
Vogel Verlag 
Zoschke 


Routine Bedeutung 

konvertiert vom RGB- ins CRT-Modell 
konvertiert vom RGB- ins CMY-Modell 
konvertiert vom RGB- ins HSV-Modell 
konvertiert vom CRT- ins RGB-Modell 
konvertiert vom CMY- ins RGB-Modell 
konvertiert vom HSV- ins RGB-Modell 


RGBtoCRT( ) 
RGBtoCMY( ) 
RGBtoHSV( ) 
CRTtORGB( ) 
CMYtoRGB( ) 
HSVtoRGB( ) 


Tabelle 2: Die dargestellten Routinen werden von PALETTE 
benutzt, um die Farbwerte von einer Mischmethode zur ande- 
ren zu konvertieren. 


einige Literatur über Computergrafik erhältlich, die dieses 
Modell behandelt und den Konvertierungs-Algorithmus von 
RGB-in-HSV enthält. 

PALETTE bietet neben einem interessanten Programm, 
das den Nutzen einer abgestimmten Steuerung durch Dia- 
logboxen zeigt, auch einen Einblick in die Mischmodelle 
und deren gerätespezifische Abhängigkeiten. 

Dieser Artikel hat Ihnen, so hoffen wir, ein besseres 
Verständnis dieser Grundlagen geliefert und einige der Un- 
sicherheiten mit Windows GDI beseitigt. Darüber hinaus 
werden Ihnen vielleicht die Farbkonvertierungs-Routinen 
bei Ihrer nächsten Entwicklung einer Windows-Anwendung 
von Nutzen sein. 

Zahlreiche gute Literatur ist erhältlich, mit eingehenden 
Abhandlungen über Farben, Farbmischmodelle und inter- 
aktive Computergrafik im allgemeinen. Eines der hilfsreich- 
sten Bücher davon ist Fundamentals of Interactive Computer 
Graphics von J.D. Foley und A. Van Dam, veröffentlicht bei 
Addison Wesley). 

Kevin P. Welch 


Profi-Tools für 
QuickBASIC 


Schreiben Sie schnellere, leistungsfähigere und 

professionellere Programme! Wir helfen Ihnen 

dabei mit nützlichen Tools. 

Zum Beispiel: 

® Toolboxen (Fenstertechnik, Menüs, 
DOS-Funktionen etc.) 

® Relationale Datenbank mit komfortablem 
Masken-Editor 

© Grafik-Paket (Geschäftsgrafik und 
Zeichensatz-Generator) 

® Maus-Unterstützung für Ihre Programme 

Alle Pakete mit ausführlich dokumentierten 

Quelltexten und Programmbeispielen. Wo erfor- 

derlich, kommen schnelle Assembler-Routinen 

zum Einsatz. Wollen Sie mehr aus Ihrem BASIC- 

Compiler herausholen? Wir informieren Sie 

gerne kostenlos! 


Ingenieur-Büro Harald Zoschke 


Berliner Str. 3, D-2306 Schönberg/Holstein 
Telefon 04344/6166 


Eingetr. Warenzeichen: QuickBASIC: Microsoft; 
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Windows 


Windows-Anwendungen intelligent erweitern: 


Selbstdefinierte Dialog-Steuerungen 


Microsoft Windows scheint, so wie auch andere 
Grafik-Umgebungen, an einer Einschränkung zu 
leiden, über die sich Programmierer fortlaufend 
beschweren. Sie sind beschränkt auf eine vorge- 
gebene Anzahl von Tools, die den Rechner stan- 
dardisieren. Es gibt jedoch, in der Tiefe des 
Windows Software Development Kit (SDK) ver- 
graben, Anhaltspunkte, das dem nicht so sein 
muß. Die kooperative Natur von Windows bietet 
einige Mechanismen, die zur Erzeugung von 
neuen und ganz unterschiedlichen Software-Ob- 
jekten herangezogen werden können. 


Eines der interessantesten davon ist die Möglichkeit, eigene 
Dialogbox-Steuerungen herzustellen. Dadurch kann man 
Windows funktionell erweitern, Anwendungen visuell 
ansprechender gestalten und die Anwenderschnittstelle 
erweitern. Es lassen sich beispielsweise Steuerungen zur 
Darstellung von Schaltern, Meßzeigern, Linealen und ande- 
ren nützlichen Einrichtungen definieren. Wir werden uns 
den Arbeitsvorgang anhand einer bestimmten Steuerung 
namens Spectrum anschauen und dessen Einsatz in einem 
Farbmischprogramm namens Palette. Im Artikel auf den 
vorangegangenen Seiten haben wir theoretisch verschiedene 
Mischmodelle erforscht. Palette kann zur Veranschau- 
lichung von drei dieser Darstellungsarten herangezogen 
werden. 


Grundlagen von Steuerungen 


Fast alles Wichtige in der Windows-Umgebung ist eine Art 
von Fenster. Standard-Dialogbox-Steuerungen sind eben- 
falls, wie Sie sicher erraten haben, vordefinierte Fenster, die 
in Ihrem gesamten Anwendungsprogramm verwendet wer- 
den können. 

Diese Steuerungen gleichen den Fenstern sehr, die auch 
in Ihren eigenen Programmen registriert oder erzeugt wer- 
den. Steuerungen sind jedoch, im Gegensatz zu den meisten 
von Ihnen erzeugten Fenstern, notwendigerweise objektori- 
entiert und bestehen vollständig aus reentrantem Code. 
Dies hat zur Folge, daß eine Steuerung weder auf statische 
Daten zugreifen sollte, noch von der Tatsache abhängig sein 
soll, ob gerade nur ein Ausführungs-Thread vorhanden ist. 
Um eine korrekte Bearbeitung durch den Dialogbox-Mana- 
ger zu gewährleisten, müssen auch alle Tastatur- und 
Mauseingaben auf konsistente Art behandelt werden. 

Obwohl die Detailarbeiten bei der Implementierung 
einer Steuerung ziemlich kompliziert werden können, sind 
die Grundschritte sehr einfach. 


Bestimmen eines Klassennamens: Jeder Steuerung muß ein 
eindeutiger Name zugewiesen werden. Der gleiche Name 
wird auch in Ihrer RC-Datei verwendet, sobald die Steue- 
rung in einer Dialogbox verwendet werden soll. 
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Windows Color Palette 


Bild 1: Das Windows-Programm PALETTE. 


Dabei müssen Sie darauf achten, keinen von Windows 
vordefinierten Klassennamen zu wählen. Die Resultate 
können ziemlich spektakulär ausfallen, wenn ein solcher 
Name versehentlich vergeben wird. 

Bestimmen aller Instanzenvariablen. Instanzenvariablen 
sind private statische Daten, die mit den jeweiligen Instan- 
zen verbunden sind. Diese Daten müssen dynamisch zuge- 
wiesen und im Zugriff für alle ausgeführten Threads stehen. 
Obgleich Sie Ihre eigenen Strukturen für Instanzenvariablen 
entwickeln können, ist es trotzdem günstig, globale oder 
lokale Atome und Eigentumslisten zu verwenden, oder viel- 
leicht extra eine Anzahl von Bytes zu definieren, die mit 
jeder Instanz der Fensterklasse-Datenstruktur in Zusam- 
menhang steht. 

Definition Ihrer Steuerungs-Fensterfunktion: Jeder Steue- 
rung muß eine Fensterfunktion zugewiesen werden, die alle 
entsprechenden Meldungen bearbeitet. Da Ihre Steuerung 
vermutlich vom Dialogbox-Manager überwacht wird, sollten 
Sie die Implementierung sowohl einer Tastatur als auch 
einer Mausschnittstelle in Betracht ziehen. Zumindest sollte 
Ihre Fensterfunktion folgende Meldungen berücksichtigen: 


= WM_CREATE: Wenn Sie diese Meldung erhalten, sollten 
Sie jede Instanzenvariable initialisieren und alle anderen 
notwendigen Initialisierungsschritte vornehmen. 

= WM_PAINT: Nach Empfang dieser Meldung sollten Sie 
jede angeforderte Anzeige im Arbeitsbereich Ihres Fen- 
sters durchführen. Sie sollten aufpassen, daß Sie die 
Ergebnisse Ihrer Anzeigeoperation für verschiedene 
Arten von Bildschirmeinheiten vorsehen, speziell jene 
mit stark abweichendem Pixel/Aspekt-Verhältnis. Dies 
ist wahrscheinlich der wichtigste und zeitaufwendigste 
Teil der gesamten Steuerungs-Entwicklung. 

= WM_DESTROY: Bei Erhalt dieser Meldung sollten Sie 
jeden Speicherbereich, der von der Steuerungsinstanz 
belegt ist, freigeben und vor der Vernichtung des Fen- 
sters alle notwendigen Löschoperationen durchführen. 


DLGC-WANTALLKEYS fängt alle Tastatureingaben ab 
DLGC-WANTALLARROWS nur Cursor-/Richtungstasten 
DLGC-WANTALLCHARS nur WM_CHAR-Meldungen 
DLGC-WANTALLMESSAGE alle Meldungen 
DLGC-WANTALLTAB Tabulator-Tasten 


Tabelle 1: Return-Codes für WM_GETDLGCODE 


Falls Sie Ihre Steuerung für Eingaben vorsehen (sowohl 
von der Tastatur als auch mit der Maus), beachten Sie, daß 
eine oder mehrere der folgenden Meldungen bearbeitet 
werden müssen: 


= WM_GETDLGCODE: Ihre Antwort auf diese Meldung ent- 
scheidet, wie der Dialogbox-Manager Ihre Steuerung 
weiterverarbeitet. Durch Rückmeldung eines Return- 
Codes aus Tabelle 1 bewirken Sie eine bestimmte Art 
der Eingabe. Die Bearbeitung der Daten wird dabei von 
Ihnen vorgenommen. 


= WM_SETFOCUS: Bei Empfang dieser Meldung sollten Sie 
eine Schreibmarke erzeugen und anzeigen, die dem 
Anwender mitteilt, daß Sie im Besitz des Eingabefokus 
sind. 


= WM_KILLFOCUS: Diese Meldung wird empfangen, 
sobald ein anderes Fenster den Eingabefokus erhält. 
Haben Sie zu dieser Zeit eine Schreibmarke definiert, 
sollten Sie diese zerstören. 


= WM_KEYDOWN: Diese Meldung wird erhalten, sobald eine 
Taste gedrückt oder niedergehalten wird. Durch Aus- 
führung der virtuellen Tastencodes können Sie jede 
nötige Operation durchführen. Stellen Sie auch sicher, 
daß dem übergeordneten Fenster jede Aktion gemeldet 
wird, die zu einem neuen Systemzustand führt, wie das 
Drücken einer Schaltfläche oder die Auswahl eines 
Objekts aus einer Objektliste. 


= WM_LBUTTONDOWN: Diese Meldung wird empfangen, 
sobald der Anwender in dem Steuerungsfenster die linke 
Maustaste drückt. In den meisten Fällen sollten Sie den 
Systemfokus übernehmen, die Mausbewegungen abfan- 
gen und Ihre Schreibmarke abbilden. Wenn durch die 
Maus eine neue Auswahl getroffen wird, ist auch das 
übergeordnete Fenster von der Veränderung zu benach- 
richtigen. 


= WM_MOUSEMOVE: Diese Meldung kann man in der Regel 
ignorieren, obwohl eine Aktion manchmal sinnvoll ist, 
wenn Sie in Zusammenhang mit einer Maus-Zieh-Ope- 
ration auftritt. 


= WM_LBUTTONUP: Diese Meldung wird empfangen, 
sobald der Anwender den linken Mausknopf freigibt. 
Wenn Sie Mausbewegungen abfangen, sollten Sie darauf 
achten, daß ab diesem Zeitpunkt die Abfangkontrolle 


wieder von Ihnen freigegeben wird. Achten Sie darauf, 
daß die Meldungen WM_LBUTTONDOWN und WM_LBUT- 
TONUP immer auftreten können, und Sie darum sicher- 
stellen müssen, daß diese Meldungen ohne sinnvollen 
Zusammenhang ignoriert werden. 


Registrierung der Steuerungsklasse: Bevor Sie eine Steue- 
rung in einer Anwendung verwenden können, müssen Sie 
die Steuerungsfensterklasse registrieren. Jeder Versuch, 
eine Steuerung zu verwenden, bevor sie registriert wurde, 
führt zu einem schweren Systemfehler und kann sogar die 
Ausführung Ihrer Anwendung gänzlich verhindern. In der 
Praxis ist es eine gute Idee, eine eigene spezielle Funktion, 
als Teil des gesamten Steuerungs-Pakets, mit dieser Auf- 
gabe zu betrauen. 

Exportieren Sie die Steuerungs-Fensterfunktion: Sie müs- 
sen diese Fensterfunktion, wie jede andere auch, vor 
Gebrauch exportieren. Selbst erfahrene Windows-Pro- 
grammierer vergessen dies oft. 

Definition von zugehörigen Dienstfunktionen: Selbst die 
Entwicklung einer einfachen Steuerung erfordert oft die 
Definition einer Anzahl von zugehörigen Dienstfunktionen, 
die der Applikation ermöglichen, verschiedene steuerungs- 
abhängige Parameter zu definieren oder zu übernehmen. 
Obgleich eine sorgfältig definierte Meldungsstruktur 
manchmal ausreicht, ist es in komplizierteren Situationen 
besser, eine eigene spezielle Funktion zu entwickeln, die 
jede erforderliche Aktion ausführt. Dies erlaubt der Steue- 
rung ein höheres Maß an Eigenständigkeit und fördert die 
Entwicklung von selbständigen Software-Objekten. 
Schließen Sie die Steuerung in die gewünschten RC- 
Dateien ein: Im allgemeinen sollten Sie den Dialogbox- 
Editor (Teil des Windows-SDK) für die Entwicklung der 
Schablonen verwenden, die in die RC-Datei übernommen 
werden sollen. Leider unterstützt der Dialogbox-Editor 
anwenderdefinierte Steuerungen nicht. Ich fand es hilfreich, 
die Größe und Position einer Steuerung mit einem stati- 
schen Rahmen zu definieren. Danach editiere ich den resul- 
tierenden DLG-Dateiinhalt und ersetze den Rahmen mit 


.der. passenden Steuerung. Beachten Sie dabei, daß der 


Dialogbox-Editor keine RES-Dateien bearbeiten kann, die 
Verweise auf anwenderdefinierten Steuerungen enthalten. 


Spectrum 


Der beste Weg, die Definition und Implementierung von 
anwenderdefinierten Steuerungen zu erklären, führt über 
ein Beispiel. Spectrum ist deshalb als Studienobjekt beson- 
ders interessant, weil es eine gut entwickelte Anwender- 
schnittstelle besitzt, die sowohl lokale als auch globale 
Instanzendaten ausnützt. 

Die Spectrum-Steuerung war das Ergebnis meiner Fru- 
stration über den Mangel an systemdefinierten Mechanis- 
men bei der Farbauswahl. Zu dieser Zeit mußte der 
Anwender, wenn er mit von mir entwickelten Applikationen 
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arbeitete, eine oder mehrere Farben aus einer Farbpalette 
auswählen. Nach einigen Versuchen mit Scrollbalken und 
Objektlisten entschied ich, daß es günstiger wäre, eine Serie 
von Steuerungen für den generellen Gebrauch zu entwer- 
fen, um solche oder andere Probleme bei Anwenderschnitt- 
stellen zu lösen. Das Ergebnis dieser Entwicklung war der 
Entwurf einer Bibliothek von Steuerungen, welche von 
Meßreglern, Schaltern und Schaltflächen bis zu Schiebe- 
reglern und anderen Selektionswerkzeugen reicht. Die 
Spectrum-Steuerung ist eine vereinfachte Version eines für 
diese Bibliothek erzeugten Tools. 

Mit Spectrum können Sie eine Folge von Farben defi- 
nieren, aus welcher der Anwender seine Auswahl treffen 
kann. Jede Farbe, die von Spectrum verwaltet wird, ist mit 
einem numerischen Wert verbunden, der dem übergeord- 
neten Fenster übergeben wird, sobald eine neue Auswahl 
getroffen wird. Dies kann ein Zeichen, Integer, Long-Inte- 
ger oder Floating Point sein. In bestimmten Situationen 
kann dieser numerische Wert sogar mit dem abgebildeten 
Rot-Grün-Blau-Farbwert (RGB) übereinstimmen. 

Die derzeit aktuelle Farbe wird durch eine kleine 
rechteckige Markierung, die diese umschließt, gekennzeich- 
net. Falls die Spectrum-Steuerung den Systemfokus besitzt, 
ist die System-Schreibmarke ebenfalls innerhalb des 
Rechtecks abgebildet. Wenn die Schreibmarke sichtbar ist, 
kann die Auswahlmarke mit den Cursortasten oder durch 
die Maus bewegt werden. 

Vor Anwendung der Spectrum-Steuerung in einer Dia- 
logbox muß diese durch die Funktion RegisterSpectrum 
registriert werden. Listing 1 zeigt einen Teil der Spectrum- 
Funktionen. (Die vollständigen Quellcode-Listings und 
Befehlsdateien für Spectrum und Palette finden Sie auf der 
gesondert erhältlichen Diskette.) Der einzige ungewöhn- 
liche Aspekt dieser Funktion ist der Gebrauch des Feldes 
cbWndExtra in der Datenstruktur WndClass. Der ange- 
gebene Wert definiert die Anzahl der zusätzlichen Bytes, 
die für jede Instanz des Spectrum-Fensters zugewiesen wer- 
den müssen. Auf diese Bytes kann dann mit den Funktionen 
SetWindowword und GetWindowWord zugegriffen 
werden. Die verschiedenen Definitionen dafür finden Sie 
am Anfang von SPECTRUMC. Vergleicht man die Offsets 
mit den vorgegebenen Offsets für GetWindowWord in 
WINDOWS.H, erkennt man, daß die in Windows.H negativ 
sind. Dies bedeutet, daß die unter cbWndExtra zugewiese- 
nen Bytes immer positiv sind und bei Offset 0 beginnen. 

Die Funktion SetSpectrunm ist eine kleine Dienstfunk- 
tion, die Ihnen die Definiton eines ausgewählten Farb- 
musters von der derzeit aktuellen Palette erlaubt. Der 
Selektor-Index wird dabei als Instanzenvariable mit einem 
vorgegebenen . Fenster-Offset abgespeichert. Analog zu 
SetSpectrum ist auch GetSpectrum eine Funktion, mit 
der man einen Index zu dem aktuellen Farbmuster erlangen 
kann. Trotz der Einfachheit dieser Funktion, ist sie sehr 
nützlich, weil dadurch die Applikation von den internen 
Details der Spectrum-Steuerung ausgeschlossen wird. 
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= WINDOWS SPECTRUM CONTROL 
eset 6 5.0 
03 SDK 


ii : : Operational 
„ 03/20/88 - Kevin P. Welch - initial creation. 
“ 


#include <windows.h> 
#include "spectrum.h” 


E RegisterSpectrum( hAppInstance ) : BOOL 
” hAppInstance Applikation-Instanzen-Handle 


“ 

* Diese Funktion dient zur Definition und Registrierung 

* der Spectrum-Fensterklasse. Sie sollte nur EINMAL 

* aufgerufen werden (T: fesberaelen in der InTEIn}\alersagenkase 
® » der Host-Applikation) innerhalb eines Programms 


N * Ein Wert TRUE wird zurückgeliefert, falls die Registrierung 
” „ erfolgreich war. 


% 


a hAppInstance ) 


/" Lokale Variablen */ 

WNDCLASS WndClass; /* Fensterklassen-Datenstruktur */ 

ie Definiert die Spectrun-Fensterklasse. Es wird nicht rüft, ob 
* bereits früher eine Registrierung stattfand! Es ist gabe” 

a Host-Applikation, mehrmaliges Registrieren zu verhindern. 


wenset( hndClass, O, sizeof(WNDCLASS) ); 


WndClass.) as jaenape - es ck Spectrum 
WndClass. SSR, Kt, oc. ARROW ): 
WndClass. TRciNemilne - 

WndClass. a - shR (es, VREDRAN; 
WndClass. «Ip Tin 
WndClass.h rumstige - piererecch 
WndClass.hIcon = MWLL; 

WndClass.cbWndExtr: SPECTRUM EXTRA; 

WndClass. NbrBackground = (HBRUSK)TCOLOR_WINDOW + 1 ); 


/* Registriert trum-Fensterklasse & Return */ 
return( RegisterClass( (LPWNDCLASS)AWndClass ) ); 


* SetSpectrumColors( hund, pwRange, problist ) : 


hund Handle auf ar hierin in Dialogbox 
PwRange Anzahl der Farbeinträ -Liste 
problist Liste der RGB-Farben BL für Spectrum 


EraRLISE dem Aufrufer, ein neues Spektrum zu definieren, 

wit zugehörigen Lookup- Werten für die Steuerung. Die 

aufrufende Reutine ise für die Bestimmung der passenden RGB-Farben 
und BI TR ISENSERE verantwortlich. Die gewählte Farbe ist 

mer auf den ersten Eintrag gesetzt, sobald ein neuer 

Bee definiert wird. 

Der Wert TRUE wird 2 zurück Bere wenn eine neue RGB-Farbliste 
erfolgreich definiert 


= 


a DR Eee ers hind, pwRange, prgblist ) 
eeilst; 


vn Ne Variablen */ je: sugerbter Verleihe et 
rer Farbeintra 
brot; le Handle auf RGB-Liste %, 
Lam ea “ Impeıt ed /* Pointer auf RGB-Liste 4, 
lien /* Anwendungs-Bereich Rechteck */ 


Linse Krk! Tabelle aus Speicherbereich frei */ 
hroblist = Slobala foe{ GHEM_MOVEABLE, sizeof(LONG)*(*pwRange)*2L): 
if Chreblist ) { 


(v ET Yrabtist s} 
ntry n 


m Kenne - eobtistlienen 


IprgbEntry[("pwRange) Kain] = 2 EN 
NobalUnlock( hroblist ): 


/* Holt aktuelle a 
GetClientRect( Tient ); 


Listing 1: Ausschnitte aus dem Programm SPECTRUM.C. 


Windows 


ddl Re-definiert Instanzvariablen a7 
SET_RANGE 


SET_TABLE Keatiet 

pas (reetClient. right-rectClient. 1200 Kee) ): 
rectClient.bottos-rectClient. 

SET nice 0); 

/* Aktualisiert Fenster & ERSEBCNTSENEIGE Parent von neuer Auswahl*/ 

InvalidateRect( hund, MÜLL, Ei 

SendHessage( P) de CORMAND: d, IprgbEntry[RANGE+CHOICE] ); 

/* Normales Return */ 

return( TRUE ); 


} else 
return( FALSE ); 


fr 
® SpectrumWndfn( hWnd, wisg, wParam, 1Param ) : 
hund 


wisg 
wParam 
1Param Double-Word-Parameter 
* Ben tet alle Meldu die zum rum-Steuerungsfenster 
be Achten Sie rauf, wie der ns geschrieben ist, 
"m Böglic che Probleme mit der Reentranz zu vermei 
* dies schließt den Gebrauch von zusätzlichen Bytes, die zur 
„ Fenster-Datenstruktur gehören, ein. 


” * Der zurückgelieferte LONG-Wert ist das konventionelle Ergebnis 
* der Standard-Fensterprozedur oder der internen Verarbeitung 
® » einer Nachricht. 
% 
ur PASCAL N hund, wAsg, wParam, IParam ) 
wParam; 
IParam; 


al Lokale Variablen */ 
Result; /* temporäre Ergebnisvariable */ 


r Initialisierung */ 
IResult = TRUE; 
switch( wis: 


case WM_GETDLGCODE : /* Fängt alle Tastenanschläge ab */ 
18% Sy] = DLGC_WANTARROWS; 


Bo vr NEREATE : 


id a ul 


/* Erzeugt Palette-Fenster */ 


FR a Merieblen "/ 
HANDLE /* Handle auf RGB-Liste */ 
LONG FAR * hai: /* Pointer auf RGB-Liste */ 


/* Alokiert Platz für RGB-Farbliste */ 
hroblist = GlobalAlloc( GMEM ROVEABLE, sizeof(LONG)*16L ); 
if (hrgblist ) { 


" Definiert RGB ARTungs farben & Wertliste - Acht 


* Standardfarben werden gewählt mit den entsprechenden 
RR für jede Farbe. 


SE ne st); 
NH 


prgbEntry[12] = RGBl 0x00, OxFF 
NhrobEnery 13] » 
1PrSBEntry 14] = 
urn try[15] » OxFF, OXFF, Off 
GlobalUnlock( hrobiist ); 


2 Big PASMBERREINNIEN “/ 
at Hi nen 


prgbEntry 00}; 
IprgbEntry[9] = RGB( Ox 
TprabEnery 1 00 “© 


EST) hpnnadj2s% m ) 
ST CHaIle hi get 
SETCAPTURE( FÄLSE ); 


else 
DestroyWindow( hind ); 


Listing 1: (Fortsetzung) 


case WN_S : /* Bestimmt Größe des Fensters neu */ 
 jul Detintert Breite und Höhe der Instanzvariablen neu */ 


SETHEIOH AvoRipanan)")e .> 


case er bar : /* Zeichnet Steuerungsfenster */ 


Ps; /* Zeichnungsstruktur */ 

ker r Aktueller Farbeintrag */ 
hBrush; /* Handle auf neuen Pinse] */ 
holdBrush; /* Handle auf alten Pinsel */ 
IprgbEntry; /* Pointer auf RGB-Liste */ 


Startet Zei ation 
butet Kae tler ER ENTSTROCT)aPS = 
/* Zeichnet iterativ alle Farbmuster 
NprobEntry en FAR alsisfailsckt Tg Tau Je 
( wEntry=Ö; wEntry<RÄNGE; wEntry++ ) 
/* Erzeugt vollen Pinsel für Muster & wählt aus */ 
hBrush = CreateSolidßrush( Iprgbenery Imentry] ) 
holdBrush = Selectübject( Ps.hdc, hörush 


/* Zeichnet Rechteck wittels Pinsel-Füllung */ 
Rectangle( 

Ps.hdc, 

wEntry"WIDTH, 

wEntry"WIOTH)+WIDTH, 

dar I 
/* Nebt Pinsel-Auswahl auf und löscht diesen */ 


Selectübject( Ps.hdc, hOldBrush ); 
Deleteübject| hBrush ); 


Irobatuntock( TABLE ); 


/* Definiert Aa Kyansgt & beendet Zeichenoperation */ 
DrawSelector( Sn 
EndPaint( hWnd, boR LIST T)J&Ps ); 


break; 
case WM_KEYDOWN : /* Taste gedrückt */ 


/* Lokale Variablen */ 
HDC N /* Kontext-Handle Bildschirm */ 
LONG FAR * IprgbEntry; /* Pointer auf RGB-Liste */ 


ld 2% Anzei ER ng & löscht Markierung aktueller Auswahl */ 
Brause! Te Nund) hoc ); 


/* Bearbeitet virtuelle Tastenanschläge */ 
switch( wParam ) 


/* Home Taste */ 
ern T enoicel 0); 


reäk 
case YK LEFT : /* Linke Cursortaste */ 
gert CHOICE (CHOICE > 0) ? CHOICE-1 : RANGE-1 ); 


a YK "kre : 5 Ben age roh hf 
se VK_SP) - Gehe nach rechts 6 
er wOIcE (enoer. < SRANGE- 1) ? CHOICE+l : 0 


case VK ‘io ; /* End Taste */ 
SET_CHOICE( RANGE-1 ); 


default H /* Andere Tasten */ 
IResult = FALSE; 
break; 


* Markiert neue Auswahl N gibt Anzeige-Kontext frei */ 
gie hoc 
ReleaseDC( hDC ); 


ke De zus Schreibmarke zu neuer Position */ 
Pos( CARET_XPOS, CARET_YPOS ); 


t Parent yon never Auswa 
AR. *)Globallock( TABLE h 
NO, 10, IprgbEntry [RANGE+CHOICE] ) ; 


ß Benachri 3. le 
bEntry = 


sel as TABLE 1 


break; 
case WH_SETFOCUS : /* Holt Fokus - Zeigt Schreibmarke */ 


/* Erzeugt Schreibmarke & bildet sie ab */ 
CreateCaret( hund, WILL, CARET_WIDTH, CARET_HEIGHT ); 
sertarethes Set. xPOS. CARET_YPOS ; 


break; - 
case WM_LBUTTONDOWN : /* Linke Taste gedrückt */ 


/" Lokale Variablen */ 
HOC DC; /" Handle auf Iaeige er 
LONG FAR ” IprgbEnt ry; /* Pointer auf RGB Liste */ 


Listing 1: (Fortsetzung) 
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/* Hole Anzeige-Kontext */ 
GetDC (hWnd ); 


hoc =» 


I" 


Löscht Markierung alter Auswahl & markiert neue */ 


DrawSelector( hWnd 
SET_CHOICE( Koran Paran) WIoTn ); 
et hWnd, hDC ) 


/* 


Rel 


/* 
if 


tv 
& 


Gibt Anzeige-Kontext frei & bewegt Schreibsarke */ 
easeDC( And, hDC ); 


Fange “rohis ab& ee Schreibwarke */ 
(.Mine se hund) Urer. 
tCaretPos CARET_XPOS, YPoS ); 


Benachrichti Parunt von neuer Auswahl */ 


bEntry = *)Globallock( TABL 
en 5 oÄhEm m 1) com. 10, Ta ELE Numsescnotce]); 


Globalunige { TABLE ) ); 


Ir 


Aktiviere Abfangen */ 


SetCapture( hund _); 
SET 


) 


TURE( TRUE J; 


break; 
case WM_MOUSEMOVE : /* Maus wird bewegt */ 


ee 


I Lokale Yarlablen MR 


fe Folge han Maus Ne wenn Abfang eingeschaltet */ 


/* Handle auf Anzeige */ 
wNewchoice;  /* Neue Auswahl durch Maus */ 


WORD 
LONG FAR * Iprgb£ntry; /* Pointer auf RGB Liste */ 


/" 


Berechne neue Auswah 


wNewChoice -( Sim A1Pkran) 0)? 


e 


( LOWORO(1Param) /WIDTA >= RANGE ) ? 
LOWORD(1Param) / WIDTH; 


Aktualisiere Anzeige, falls verschieden */ 


if ( wNewChoice I= CHOICE ) { 


) 


/* Holt Anzeige-Kontext */ 
hDC = GetDC (hund ); 


/* Löscht alte Auswahlmarkierung & markiert neue */ 
Er hund, hDC ); 

SET_CHOICE( wNewChoice ); 

Drawselector( hund, hDC j; 


/* Gibt een frei & bewegt Schreibmarke */ 
ReleaseDdC( hwı 
SetCaretPos( CARE Xpb, CARET_YPOS ); 


/* Benachrichtige Parent von neuer Auswahl */ 

Ip Beakıy "AL FAR Det oballock( TABLE 
gel? NT, m “ 

Globaluniee ( TABLE ) 


break; 
case WM_LBUTTOWP : /* linke Maustaste wird freigelassen */ 
fr ir ji frei */ 


if 
Rel 
) 


TICAPND ( FALSE ); 
easeCapture(); 


brea 
case er KıLLFocus : /* löscht Fokus - Verdeckt Schreibmarke */ 
Dest Be ; 


case WM 
oe 


brea 
default : 

]Resul 

break; 


u ru Fenster */ 
re TABLE 


: /* Vo bene WINDOWS Meldungsbearbeitung */ 
t = DefWindowProc( hund, wAsg, wParam, IParam ); 


/* Liefert Endresultate zurück */ 


return( ] 


Listing 1: 
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Result ); 


(Ende) 


0,10, a Rev Iönncescnotce]): 


Wie bereits erwähnt wird bei Erzeugung einer Instanz 
für das Spectrum-Fenster ein voreingestellter Satz von Far- 
ben automatisch erzeugt. Durch die Funktion SetSpec- 
trumColor können das vorgegebene Farbset und die 
damit verbundenen numerische Werte neu eingestellt 
werden. Dabei wird die Farbauswahl auf die erste Farbe der 
Reihe zurückgesetzt und das übergeordnete Fenster von der 
Änderung benachrichtigt. Die Auswahl der verfügbaren 
Farben besteht aus einer Reihe RGB-Farben, gefolgt von 
einer Reihe damit verbundener numerischer Werte, die bei 
der Auswahl einer Farbe zurückgegeben werden. 

Durch die Funktion GetSpectrumColors können Sie 
sich die gerade aktuelle Farbe und Wertetabelle der Spec- 
trum-Steuerung beschaffen. Es wird dabei nicht geprüft, ob 
genügend Platz für die Liste der Werte vorhanden ist. Dies 
kann leicht hinzugefügt werden, es ist jedoch der Appli- 
kation normalerweise die Menge der Werte bekannt, die 
verwaltet werden sollen. 

Die Funktion SpectrumWndFN ist vielleicht der schwie- 
rigste Teil des gesamten Programmcodes der Spectrum- 
Steuerung. Obgleich strukturell sehr einfach aufgebaut, ist 
sie für die enge Zusammenarbeit mit dem Dialogbox- 
Manager entworfen. Dies zeigt sich in der Art wie auf 
WM_GETDLGCODE geantwortet wird. Der zurückgelieferte 
Wert DLGC_WANTARROWS benachrichtigt den Dialogbox- 
Manager, daß die Steuerung die Verwaltung der Cursor- 
tasten übernehmen will. Dies erlaubt der Steuerung, eine 
Tastatur-Anwenderschnittstelle für die Farbauswahl aufzu- 
bauen. 

Beachten Sie, wie der Befehl WM_SIZE verarbeitet wird. 
Unter normalen Umständen wird meistens keine 
Größenänderung für Steuerungen vorgenommen. Die Bear- 
beitung dieses Befehls unterstützt jedoch diese Möglichkeit. 

In der Funktion SpectrumWndFN sehen Sie einige 
SendMessage-Funktionsaufrufe, die bei jeder Verände- 
rung der Auswahl dem übergeordneten Fenster eine Mit- 
teilung senden. Wie in den meisten anderen Steuerungen 
werden Informationen mit der Meldung WM_COMMAND dem 
übergeordneten Fenster mitgeteilt. Der wParam-Teil dieser 
Meldung entspricht der Unterfenster-ID (dieser Wert wird 
mit einem dieser negativen Fenster-Offsets ermittelt) und 
der 1Param-Teil ist der von der Auswahlfarbe abhängende 
numerische Wert. 

DrawSelector ist die letzte Funktion von 
SPECTRUMC. Diese Hilfsfunktion ist für die Erzeugung 
der Auswahlmarke verantwortlich, die das ausgewählte 
Farbmuster hervorhebt. Der Zeichenmodus TRANSPARENT 
wird mit dem Operator R2_NOT verwendet. Dadurch kön- 
nen weitere Aufrufe der Funktion den Originalzustand der 
Darstellung wirksam wiederherstellen, wodurch Teile von 
Spectrum während bei Bewegungen der Auswahlmarke 
nicht neu gezeichnet werden brauchen. 


= WINDOWS COLOR PALETTE UTILITY - SOURCE 


* LANGUAGE : Miecmsett: „3 5.0 
= TOOLKIT 3 Windows 2 03 SDK 
* MODEL Saal] 

x STATUS : : Operatichel 


y 03/20/88 - Kevin P. Welch - initial creation. 
in { 

Hinclude windows.h> 

#include ath.h> 


Finclude *spectrum.h* 
#include *palette.h* 


case WM_COMHAND : /* Fenster-Befehl */ 


j* erheben: Sub-Meldu: 7} 
seither) 


: /® RGB Mischnodel] */ 
Nischmodel] */ 


case ID a /* 1. Spektrum */ 
u wiodel ) 
Obeelor fRed - urIea ge“ era); 
ER sr argkeler er; eeler 
Digprint (ADIS: 1D-VALUEL, 44.37”, rgbColor.fRed ); 


case ID av: 
zuialer, ‚fCyan - jet ara 


ge 


nn Biprint ( Bois: 1% ana bu.3f%, cmyColor.fCyan ); 
case 10 Kl 
hsvColor, ee - tee t* Srarem); 
ehe or 


ae Kos; I 1 as ALUEL, ni Of", hsvColor.flue ); 


I" 
x Winkain( hinst, hPrevInst, IpszCmdline, wCndShow ) : int 


Handle der aktuellen Instanz 

Handle auf Instanz (falls vorh.) 
Pointer auf Befehlszeile-Argumente 
Initalisierender Showkindow Befehl 


” 

5 

5 

* Diese Funktion ist der Systemstart der Applikation 

* und definiert die rem Fensterklassen und bearbeite 
a be trennt EU teen 3. die 
® tu „Fensters verantwortlic) 

se « Mi en GetDlgItem(hDlg,1D_SAMPLE), NULL, NULL ); 


/ 


int PASCAL Winkain( RIM: hPrevInst, IpszCmdline, wCndShow ) 
er hinst; 
hPrevinst; 
IpszCmdline; 
Show; 


/* Lokale Verlabien ne 
FARPROC IpProc; /* zeitweilige Funktion */ 


break; 
case ID_SPECTRUMZ : /* 2. Spektrum */ 


switch( wodel ) 
case ID.Rc8 
ee .fGreen = jo. Bemelor 


aräkeler vColor 

ee digprint ( holg, I" )_VALUE2, ig. 3f*, rgbColor.fGreen ); 

Gmgistelere Fenster wenn erste Instanz */ case IB.0h : 
f ( hPrevinst || RegisterSpectrum(hinst) ) ni 


1 Zeigt PALETTE Diategben, in 4 

IpProc = MakeProcinstance( re ealsstedigre, hinst ); 
DintogBont hinst "Palette" „MLL, 

FreeProcinstancel IpProc ); 


0x Magenta = *((float”)älParam); 
or. lor ); 
R6BtoH! al &hsvColor ); 
Dloprint ( IP 1D_VALUE2, *%.3f", cmyColor.fMagenta ); 
case ID HSV : 
hsvlolor. fSaturation - BC LEIee alter); 
Be Msyco) BERG Is 


) 
print NO15: 10 VALUEZ, 34.3”, hsvColor.fSaturation ); 


/* Beendet Programm */ 
return( FALSE ); 


Iratieutetsett GetDigItem(hD1g,ID_SAMPLE), MLL, WLL ); 


break; 
case 1D_SPECTRUNZ : /* 3. Spektrum */ 
switch( wiodel ) 


PaletteDlgFfn( hWnd, wAsg, wParam, 1Param ) : BOOL 
hund Handle auf PALETTE Fenster 


}Param Double-Word-Parameter 


Bearbeitet alle od die sich auf die PALETTE- 
Dialogbox beziehen. umfaßt hauptsächlich 

die Definition und frage der verschiedenen Farben, 
die vom Anwender gewählt sind. 


>: „fBlue ato Bemr ]e 


de Koig. 10, Hoyatues, i "4.3f", rgbColor.fBlue ); 


eaer, Kuetlae! - un a 


1 Boris ( Bat: ee klues, iy, 3f*, emyColor.fYellow ); 


ee 


BOOL NA PASCAL PRESSEN hDig, wisg, wParam, 1Param ) 
Eh 
vOord > ker tue = Tl 
digprin ( Adtsr 10_\ Ailes, ig. 3f*, hsvColor. fValue ); 
/* Ergebnis der Funktion */ break; 


/* Initialisierung */ ER GetDigitem(hDlg,ID_SAMPLE), NULL, MWLL ); 


bResult = TRUE; 


/* Bearbeitet Meld #7 
switch( sg ) Stern 


case WM_INITDIALOG : /* Initialisiert Dialogbox */ 
/* wählt CRT Mischmodell */ 
w#odel = ID $ 
SelectMixingModel( hDlg, wAodel ); 
/* Definiert Sinnbild für Dialogbox */ 
SetClassword( 
hDig 
GCW_HICON, 
Loadicon( INSTANCE, (LPSTR)"Palettelcon* ) 


break; 
case ID_SÄMPLE : /* Farbmuster Reihe */ 


I” Upda ir, wenn nötig “ 
it ( a ea ont") 1 


/* Lokale Variablen */ 
KOC hoc; 


RECT rectClient; 


/* Zeigt CRT äquivalente numerische Wert */ 
lor, äcrtValue 
Bu { "RED, "RED iur, ertValue.ched ); 


: ho "GREEN ku”, crtValue.cGreen ); 
hDlg, 1D_BLUE, " "BLUE %u*, crtValue.cBlue ); 


[ zu a altes „ 
ee [t IR, BrectClient ); 


Listing 2: Auschnitte aus dem Programm PALETTE.C. Listing 2: (Fortsetzung) 
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case ID_HSV : 


SetDlgItemText Keld: 10_TITLEI, 
SetDigItemText| hDlg, ID_TITLEZ, eSataration:e 
SetDlgItemText| hDlg, ID_TITLE3, "Value 


wEntry = MatchColor Bern. hsvColor.fHue); 
Set gpsctrankolerel 1, SwRange, hsvHue ); 
SetSpectrum( SPECTRUMI, Le ); 


wentry = Mat eteler Bersateration: hsvColor.fSaturation); 
SetSpectrumCo al „ SmRange, hsvSaturation ); 
SetSpectrum( Ser RUNZ, ale Js 
wEntry = ee „hsvColor. „iRalme)e 
gertpeetrie! ors BnN hswalue ); 
SetSpectrum( SPECTRUM3, BwEntry 


break; 


/* Erstellt Aaasige-Kontent er 
holdBrush = Selectübject( 


CreateSolidßrush( *((DWORD*)&crtValue) ) 


F 
’ 


je Bas Farbreihe */ 


rectClient.left, 
rectClien 

rectClient.right, 

rectClient.bottom 


/* Lösch gibt Anzeige Kontext frei */ 
Beiataln a Seleetonjeet{höc eh lee ): 
(1Param), hDC ); 


breal 
ana z\ K Etwas anderes */ 


ir 
» HatchColor( plTable, fValue ) : jEntry 


x DITSbIE Tabelle für Farbwerte 


RN 
case WM NCLBUTTONDBLCLK : f: Anwender-fremder Doppel-Klick */ = Zu suchender Wert 


endpieogl hDlg, TRUE 


” = Hilfsfunktion, die eine Spectrum-Tabelle nach 

* einem bestimmten EINEr»O mittels vorhandenen Schlüssels, durchsucht. 
* Ein Index zum age en Ebenbild wird zur weiteren Verwendung 

# » zurückgeliefer 


defa er 
BResult” = FALSE; 


break; wenn zwischen Farbwischmodellen Ingsschaltacn wird. 


" Es kann vorkommen, kein exaktes Ehenbitd. er ist (aufgrund 
* der diskreten Natur der Seskeres Tate) la} Al bnis 
) = können einige Unterschiede in der result runden male sichtbar sein. 
“ 
static int ent plTable, fYalue ) 

LONG * 


float 'alue; 


/* Liefert E is zurück */ 
return( bResult ); 


3 


a 


SelectHixingHodel( hDIg, wNewiodel ) 


hDlg Handle auf PALETTE-Dialogbox 
wNewtodel ID des neuen Mischmodells 


Wechselt vom ag rk har Farbenmischmodel | 
zu einem neuen. wird das FRERRDOEENn 
Bene und ein Versuch unternommen 
bild der derzeit definierten an Tarbe, in 
Mischmodell zu finden. 


{ 
iEntry; 
INin tan; 
Minimum; 


/* Initialisierung */ 
iMinimum = 0; 
fMinimum = ABS(*((float*)8plTable[16])-fValue); 


r i” eg Fi 
” CAR (etlrton® Setlatatikeer)]]- fYalue) < Minimum ) { 
Minimue - ABS(e{(froate)äplTable[iEntry])- fYalue); 


” 
/ 
void une 1( hölg, witewlodel 
oe ( holg ) 
FuNenttodel ; 
E Lokale Variablen */ 
WRange; 
WORD wentry; 


/* Definiert neuen Bereich & prüft radio */ 
wRange = 16; 

wHodel = wilentiodel ; 

CheckRadioßutton( hDlg, ID_RGB, ID_HSY, wiodel ); 


{ 
} 


/* Liefert besten Eintrag zurück */ 
return( iMinimum ); 


/* Initialisiert, in Abhängigkeit vom Modell */ 
switch( wNewHodel ) 


case ID_RGB : 


Sagt] M ADS: 10-7 1D Tine ES Go Listing 2: (Ende) 


SetDigltemText 

SetDigitemText( hD1g, ne: "Blue... 

went MatchColor(rgbRed,rgbColor. fRed 
SetSpectrusColors RUN] mRange, nes IE 
SetSpectrum( RUNI, äwEntry ); 


wentry = PaSENDEVOrTFgBBrenn bLolor .Torsen); 
ech CTRUNZ, nge, rgbGreen ); 
SetSpectrum( SPECTRUNZ, mentry ); 


wEntry = MatchColor(rgbBlue,rgbColor. Greg 
SetSpectrumColors( SPECTRUNS, five ); 
SetSpectrum( RUM3,, AwEntry a 


break; 
case ID_CHY : 


Sunantaten| hdlg, ID HUEL a r 


ade Men Me Nam 


m. “ 
on . nn. 
Kate at iun, Malte ma 170 


u EEETTTTTTN 
DE 17100 00 20 Bo Ei Eu EEE 
nur TI 


color Horoll 


SetDigItemText| hD1g, ID_TITLI 
SetDlgItemText( hDIg, IO-TITIEs: "Yellow.... 


= MatchColor or.ftC; 
etfpetrmiolsrt (ans re alyan }r 
Seen. Entry ); 
Se = Esgaye ta ee): 
ÄGELTRöRE. ünkenge, caügent) 
ehe PECTRURZ,, ämEntry rag 
ar MatchColor(cmyYellow, Hör: Eallen)s hi 
rumColors RUM: , 5 ellow ); 
SetSpectrum( RUM3, SwEntry ); rn 
break; 


horn LE EITE 


” T| 


); 


Listing 2: (Fortsetzung) Bild 2: Ein Vergleich von ColorScr und Palette. 
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Windows Color Palette 


Color Mixing Model ] fSanmple- 
Red, Green, Blue. RED 255 
fevan. Magenta, Vellow. GREEN 0 
Öhue, Saturation, Value. BLUE 255 


Color Hıxture 3 
:OIILILLITITITEFRRR 
UI ITTTETRRRRRE 


Magenta... : 
Yellow 


Windows Color Palette 
rColor Mixing Model Samle 
Ö Red, Green, Blue. RED 
Ütyan, Nagenta, Vellow. GREEN 0 
[fie Saturatıon, Value. BLUE 255 
se 


Color Mixture 


SSRETTITTTLT 1 1.00 


Windows Color Palette 
Color Mixing Model Sanple 
W Red, Green, Blue. REN 255 
|| GREEN 0 


Hue, Saturatıon, Value. BLUE 255 


| cyan, Magenta, Yellow. 


Color Mixture 


Bild 3: Das Programm Palette kann nicht nur Farben in drei 
verschiedenen Modellen anzeigen, sondern es kann auch Far- 
ben und Farbmischwerte beim Umschalten zwischen den 
Modellen anpassen, wie mit diesen Bildschirmen gezeigt wird. 


Windows Palette 


Nachdem Sie nun verstehen, wie eine anwenderdefinierte 
Steuerung arbeitet, wollen wir ihren Nutzen anhand einer 
kleinen Anwendung anschauen. Windows-Palette ist eine 
logische Erweiterung des Programms ColorScr von Charles 
Petzold (siehe MSJ März/April 1988, Seite 34). Palette 
ermöglicht wie ColorScr auch das Mischen von RGB-Far- 
ben zum Erstellen einer selbstdefinierten Farbmischung. 
Palette verwendet jedoch im Gegensatz zu ColorSer die 
Spectrum-Steuerung und erlaubt das Mischen mit zwei 
zusätzlichen Farbmischmodellen (Bild 2). Darüber hinaus 
wird beim Wechseln von einem Modell zum nächsten der 
Versuch unternommen, im neuen Modell die gerade defi- 
nierte Farbe darzustellen (Bild 3). 


Wenn sie PALETTE.C untersuchen, erkennen Sie die 
Datenstrukturen, die beim Arbeiten mit den vier Modellen 
verwendet werden: 


CRT GDIRot-Grün-Blau 

RGB Rot-Grün-Blau 

CMY  Cyan-Magenta-Gelb 

HSV _Farbabtönung-Sättigungs-Wert 


(hue saturation value) 


Das CRT-Modell ist direkt analog zum RGB-Modell, 
das vom Graphics Device Interface (GDI) unterstützt wird. 
Beachten Sie, daß ein Unterschied zwischen dem GDI- 
RGB-Modell und dem von Palette unterstützten RGB- 
Modell besteht. Während der Mischung einer Farbe werden 
die RGB-, CMY- und HSV-Werte verwendet, um einen 
äquivalenten RGB-GDI-Wert (in der Folge CRT genannt) 
herzustellen, der in der rechten oberen Ecke des Palette- 
Fensters dargestellt wird. Sie erfahren mehr über Farb- 
mischmodelle in dem vorausgegangenen Artikel über 
Farbmisch-Grundlagen. 

Das verwendete Fenster, mit dem in der Applikation 
gearbeitet wird, ist in PALETTE.RC als PALETTE-Dia- 
logbox definiert. Obwohl dieses Fenster ursprünglich mit 
dem Dialogbox-Editor erzeugt wurde (Teil des Windows- 
SDK), wurde es in wichtigen Teilen manuell verändert. 

Die erste Veränderung war das Hinzufügen von 
WS_MINIMIZEBOX zur Liste der Dialogbox-Stil-Attribute. 
In Kombination mit einer geringfügigen Änderung der Fen- 
sterklassen-Datenstruktur kann die Dialogbox zu einem 
Sinnbild werden. 

Die zweite Änderung betraf die Schaltfläche 
ID_SAMPLE. Der Schaltflächen-Stil wurde verändert, sodaß 
die Schaltfläche am Anfang ausgeschaltet wird und das 
übergeordnete Fenster den Schaltflächeninhalt zeichnet. 
Dies wurde durch Veränderung des Schaltflächen-Stils zu 
BS_USERBUTTON ! WS_DISABLED:!WS_CHILD erreicht. 

Die dritte Veränderung war das Hinzufügen dreier 
Instanzen der Spectrum-Steuerung zur Dialogbox-Defini- 
tion. Bei der Arbeit mit dem Dialogbox-Editor werden die 
Größe und Position der Spectrum-Steuerung durch einen 
statischen Rahmen vorherbestimmt. Alle Rahmen werden 
später entfernt und dafür die Spectrum-Steuerung in Origi- 
nalgröße eingesetzt. 

Beim Start von PALETTE.C werden neun kleine Arrays 
definiert, die die voreingestellten Farbtabellen für das 
Spectrum-Steuerungsfenster enthalten. Die ersten drei 
Tabellen bestimmen die vorgegebenen Farbwerte für die 
Rot-, Grün- und Blau-Spektren. Jede Tabelle besteht aus 
16 CRT-Werten, gefolgt von 16 Long-Darstellungen Ihrer 
Fließkommawerte. (Im theoretischen RGB-Modell liegt 
jeder Farbwert im kontinuierlichen Bereich {0,1}, wogegen 
das CRT-Modell diskrete Werte im Bereich {0,255} 
benutzt.) Das zweite und dritte Tabellen-Triple definiert die 
Standard-Werte für das CMY- bzw. HSV-Modell. 
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Obgleich die Spectrum-Steuerung keine obere Grenze 
für die Größe der Farbtabellen festlegt, muß doch jedes 
dargestellte Farbmuster genügend groß sein, um leicht 
sichtbar zu sein. In Verbindung mit dem Vorschlag für die 
maximale Größe von Dialogboxen aus dem »Windows Style 
Guide« ergibt sich eine praxisbezogene obere Grenze von 
etwa 30 Farbwerten. 

Die Funktion WinMain in PALETTE.C (Listing 2 zeigt 
einige Funktionen) unterscheidet sich von denen, die Ihnen 
bisher untergekommen sind. Im Unterschied zu einem kon- 
ventionellen WinMain besitzt dieses keine Meldungsschleife 
- der Empfang und die Abfertigung von Meldungen wird 
dem Dialogbox-Manager überlassen. Abgesehen von der 
Erzeugung einer Dialogbox, ist der einzige andere Zweck 
dieser Routine die Registrierung der Spectrum-Steuerung 
durch Verwendung der aktuellen Instanzenhandle als Para- 
meter. Falls eine vorhergegangene Instanz der Applikation 
existiert, wird die Spectrum-Steuerung nicht neu registriert. 

Die Funktion PaletteDlgFh ist, wie die meisten ande- 
ren Dialog-Funktionen, für die Bearbeitung aller Meldun- 
gen verantwortlich, die mit der PALETTE-Dialogbox in 
Zusammenhang stehen. Die meisten dieser Funktionen 
bestehen aus Standard-Windows-Code, mit einigen Aus- 
nahmen in kritischen Gebieten. 

Die erste Ausnahme ist die Art, in der die Meldung 
WM_INITDIALOG verwaltet wird. In diesem Abschnitt wird 
das Dialogbox-Sinnbild (vorbelegt mit NULL) mit einem 
Aufruf der Funktion SetClassWord definiert. Dieser 
kleine Unterschied ermöglicht der Dialogbox, bei 
gleichzeitigem Hinzufügen von WS_MINIMIZEBOX zum 
Fenster-Stil, zu einem Sinnbild zu werden. 

Die zweite Ausnahme ist die Verwaltung der Spectrum- 
Unterfenster-IDs bei der Bearbeitung der Meldung 
WM_COMMAND. Wie bereits bei der Besprechung der Funk- 
tion SpectrumWndFn erwähnt, wird ein WM_COMMAND (mit 
wParam gleich der Unterfenster-ID und 1Param gleich 
dem zugehörigen numerischen Wert) immer dann erzeugt, 
wenn der Anwender eine neue Farbe aus dem Spektrum 
auswählt. Sobald diese Meldung von der Dialog-Funktion 
empfangen wird, wird der passende Farbwert (mit einer 
Long/Float-Umwandlung) definiert, der zutreffende Farb- 
wert berechnet und der numerische Wert im Textfeld rechts 
neben der Spectrum-Steuerung abgebildet. 

Das dritte kritische Gebiet ist die Verarbeitung von 
ID_SAMPLEID bei der Bearbeitung von WM_COMMAND. Die 
PALETTE-Dialogbox enthält eine anwenderdefinierte 
Schaltfläche. Wann immer die Schaltfläche neu gezeichnet 
werden muß, ist HIWORD(1Param) gleich BN_Paint und 
LOWORD(1Param) gleich der Schaltflächen-Fenster- 
Handle. Durch Übernahme des Bildschirm-Kontextes für 
diese Schaltfläche können wir eine Reproduktion der 
gegenwärtig gewählten Farbmischung herstellen. 
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Die Funktion SelectMixingModel ist verantwortlich 
für das Umschalten der PALETTE-Dialogbox auf ein neues 
Farbmischmodell, sobald eines gewählt wird. Dabei wird ein 
Update der zugehörigen Textfelder und abgebildeten Farb- 
spektren vorgenommen, um das neue Modell zu berück- 
sichtigen. Es sucht auch nach dem ähnlichsten Ebenbild der 
aktuellen Farbe im neuen Modell. Obgleich diese Anglei- 
chung normalerweise zu einer beinahe identischen Farbe 
führt, gibt es Situationen, in denen die Ganzzahl-Natur der 
Spectrum-Steuerung diesen Prozeß behindert und es zu 
einer leichten Veränderung der Farbe kommt. 

Die Funktion MatchColor ist für das Bestimmen des 
besten Ebenbildes unter Verwendung der neuen Farb- 
Spektrum-Tabellen verantwortlich. Dieser Prozeß der 
Angleichung ist relativ zuverlässig und führt in den meisten 
Fällen zu vernünftigen Ergebnissen, obwohl er nur lokale 
Optima und Extremwertpunkte verwendet. 

Die Funktion D1gPrintf arbeitet wie sprintf, außer 
daß die Ausgabe an eine Dialogbox-Textsteuerung geleitet 
wird. Für jene, denen die Strukturen in diesen Routinen 
unbekannt sind: Die Funktion vsprintf ist ein Standard- 
Aufruf der Bibliothek der Microsoft C Version 5.0, der ein 
sprintf mit einer variablen Anzahl von Argumenten 
durchführt. 

Der Rest des Palette-Moduls besteht aus sechs Farb- 
umwandlungen, die einen Farbwert in einen anderen kon- 
vertieren. Jede dieser Routinen ist im vorhergegangenen 
Artikel detailiert erklärt. 


Programm-Erstellung 


Zur Erzeugung einer ausführbaren Datei PALETTE.EXE 
brauchen Sie den Microsoft C 5.0 Compiler (oder eine 
spätere Version) und das Windows Software Development 
Kit ab Version 2.03. Bevor Sie die Applikation zum Laufen 
bringen können, müssen Sie möglicherweise einige Ände- 
rungen der LNK- und DEF-Dateien durchführen, um Ihre 
Festplattenstruktur zu berücksichtigen. 

Nachdem Sie diese Veränderungen vorgenommen 
haben, können Sie PALETTE.EXE mit dem folgenden 
Befehl erzeugen: 


MAKE PALETTE 


Nach dem Kompilieren und Linken des Programms 
können Sie mit PALETTE auf Ihrem Computer experi- 
mentieren. Wie Sie sehen werden, ist das Entwerfen eigener 
Dialogbox-Steuerung eine einfache Aufgabe, die jede 
Anwenderschnittstelle stark erweitern kann. Mit ein wenig 
Mühe können Sie Spectrum auch für einige andere interes- 
sante Steuerungen verwerten. Es wird nicht lange dauern 
und Sie entwickeln Ihre eigenen Software-Toolboxen für 
das nächste interessante Projekt. 

Kevin P. Welch 


Fenster und F rkl 


n unter Windows (Teil 1): 


Einführung in Fenster-Unterklassen 


Es ist einsichtig, daß bei Microsoft Windows der 
Begriff des Fenster (»Window«) eine wichtige 
Rolle spielt. Andererseits sind die zahlreichen 
Möglichkeiten, die die Fensterverwaltung von 
Windows dem Programmierer bietet, ziemlich 
unbekannt, da das Windows-SDK /I1] darauf 
nur am Rande und ohne weitergehende Beispiele 
eingeht. In diesem Artikel und einem weiteren 
im nächsten Heft wird detailliert auf Windows- 
Fenster eingegangen. 


Die Anwendungs-Beispiele im Programmer’s Leaming- 
Guide besitzen alle den gleichen Aufbau: Einerseits ein 
ziemliches kleines Hauptprogramm, welches die Anwen- 
dung initialisiert und die bekannte Windows-Meldungs- 
schleife besitzt und andererseits eine Fensterfunktion, wel- 
che alle an die Anwendung gesandten Nachrichten verar- 
beitet und den Inhalt des Anwendungsfensters zeichnet. Zu 
diesen beiden Hauptteilen kommen dann noch Unterpro- 
gramme und einige Funktionen zur Verwaltung der Dialog- 
felder (Dialog Boxes). Hat man als Anfänger die Struktur 
einer solchen Anwendung verstanden, ist man versucht, 
seine konkrete Programmieraufgabe in dieses Schema zu 
pressen. So werden dann weitere Dialogboxen hinzugefügt 
und die Komplexität der Anwendungsfensterfunktion steigt 
bei komplizierten Programmen mit umfangreicheren Zei- 
chenaufgaben (zum Beispiel Wysiwyg-Textverarbeitung 
oder CAD-Programm) gewaltig an. Das Programm wird 
zunehmend unstrukturierter und auch kompliziert zu war- 
ten. Oft ließe sich dies vermeiden, würde man die Zeichen- 
fläche eines Fensters in mehrere kleinere Teile aufteilen, 
die weitgehend unabhängig voneinander gezeichnet werden 
können. Diese Strukturierung wird von Windows mit 
Tochterfenstern (Child windows) und selbstdefinierbaren 
Fensterklassen hervorragend unterstützt. Womit wir beim 
Thema wären. 


Die Aufgabe eines Fenster 


Zunächst wollen wir jedoch ein wenig Abstand nehmen von 
der eingefahrenen Anwendungsstruktur des Windows-SDK 
und untersuchen, warum eigentlich Windows-Programme 
so merkwürdig aufgebaut sind. Bild 2 zeigt den allgemeinen 
Aufbau einer Windows-Anwendung. Der Kern ist eigentlich 
weitgehend identisch mit einem normalen DOS-Programm. 
Hier erfolgen die Initialisierung, Datei-Ein-/Ausgabe, 
Geräteausgabe, interne Berechnungen usw. Zwei wichtige 
Dinge fehlen jedoch: die Verwaltung jeglicher Eingaben von 
Tastatur und Maus und die Ausgabe an den Bildschirm. 
Warum ist das so? Nun, bei Windows erfolgt die Kommuni- 
kation einer Anwendung mit dem Benutzer nicht direkt 
über Tastatur, Maus und Bildschirm sondern generell über 
Fenster. Wenn ein Fenster am Bildschirm sichtbar ist, kann 
der Benutzer die Ausgabe in diesem Fenster registrieren. 


ee —_—_—_[__1419 
Datei Liste Sonstiges 
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SUBLST.BAK 
SUBLST.DOC 


Windows Subelassing Demonstration 


Bei der _finderung von Texten im Überschreibmodus wird immer ein 
loanzes Beichen markiert. 


Bild 1: Das Beispielprogramm SUBCLASS für die Demon- 
stration von Fensterklassenerweiterungen. 


Wenn zusätzlich das Fenster den »Eingabefokus« 
erhalten hat, kann der Benutzer mit der Anwendung dieses 
Fensters über Maus und Tastatur im Dialog kommunizie- 
ren. Durch die Verlagerung der Konsolen-Ein-/Ausgabe 
vom Kern der Anwendung zu deren Fenstern wurde die 
standardisierte Ein-/Ausgabe von Windows ermöglicht, die 
beispielsweise einen einfachen Wechsel zwischen geladenen 
Anwendungen ermöglicht. Wird eine Taste gedrückt oder 
die Maus bewegt, schickt Windows eine entsprechende 
Nachricht an das Fokus-Fensters wo sie von der Fenster- 
funktion verarbeitet wird. 

Eine weitere wichtige Aufgabe der Fensterfunktion ist 
das Zeichnen des Fensterinhalts (Client Area). Warum 
übernimmt dies nicht der Kern der Anwendung? Nun, beim 
Verschieben oder Vergrößern eines Fensters muß der Fen- 
sterinhalt teilweise neu gezeichnet werden. Hierzu wird 
dem entsprechenden Fenster die Nachricht WM_PAINT 
zugesandt und die Fensterfunktion zeichnet den Fenster- 
inhalt teilweise neu, ohne jedoch die Bedeutung der Aus- 
gabe zu verändern. Da dieses Zeichnen unabhängig vom 
Entstehungszeitpunkt der Ausgabe-Daten durchführbar 
sein muß, ist es sinnvoll, den Zeichenprozeß vom Kern der 
Anwendung in die Fensterfunktion zu verlagern und im 
Kern nur die Daten für die Ausgabe zu erzeugen oder zu 
ändern und dem Zeichenprozeß zur Verfügung zu stellen. 
Bei jeder Änderung der Daten fordert der Kern explizit die 
Fensterfunktion auf, den Fensterinhalt den Datenänderun- 
gen anzupassen. Dies geschieht im allgemeinen durch Auf- 
ruf der Funktionen InvalidateRect und UpdateWin- 
dow, beide senden im wesentlichen WM_ERASEBKGND- und 
WM_PAINT-Nachrichten an die Fensterfunktion. 

Es gibt also eine Trennung zwischen Erzeugung und 
Ausgabe der Daten, im Gegensatz zu vielen DOS-Program- 
men, bei denen Daten zum Beispiel Zeile für Zeile aufbe- 
reitet und anschließend sofort ausgegeben werden. Jetzt 
werden einige Leser einwenden, daß sie noch nie den Quell- 
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Windows 


Nachrichten 


Nachrichten 


Bild 2: Prinzipieller Aufbau einer Windows-Anwendung. 


code eines Windows-Programms gesehen haben, in dem die 
Ausgabedaten außerhalb der Fensterfunktion erzeugt 
wurden. Vielmehr geschehe meist auch die Erzeugung in 
der Fensterfunktion und nicht im Kern. Diese Aussage ist 
nicht ganz falsch, da es sich bei den meisten veröffentlichten 
Windows-Programmen um ausgesprochen dialogorientierte 
Anwendungen handelt. Hierbei werden Fensterausgaben als 
direkte Folge von Benutzereingaben unmittelbar erzeugt 
oder geändert. Da die Fensterfunktion die Eingabe ver- 
waltet, ist es naheliegend, auch die Datenerzeugung der 
Fensterfunktion zu übertragen anstatt einen Umweg über 
den Anwendungskern zu gehen. Es sind jedoch auch Win- 
dows-Programme denkbar, die mehr im Hintergrund ablau- 
fen und zumindest zeitweise wenig dialogorientiert sind. 
Hierzu zählen zum Beispiel Compiler oder Tabellenkalku- 
lationsprogramme während der Berechnungen der Daten. 
Bei solchen Programmen erfolgt die Hauptarbeit bei der 
Datenaufbereitung im Kern und nicht bei der Ausgabe, und 
Ausgabeänderungen erfolgen nicht auf Anweisung des 
Benutzers sondern durch die Anwendung selbst. Dieser 
Umstand ist wichtig zu wissen, wenn man beabsichtigt, eine 
DOS-Anwendung auf Windows umzuschreiben: Je weniger 
Ein-/Ausgabe ein Programm benötigt, umso weniger muß 
man letztendlich neu schreiben. Andererseits: Hat man es 
erst einmal geschafft, einen ein-/ausgabeunabhängigen 
Kern einer Anwendung herauszukristallisieren, kann man 
ein solches Programm auch mit geringerem Aufwand an 
andere Grafiksysteme anpassen wie Presentation-Manager, 
Apple-Macintosh, UNIX-Presentation-Manager ... 


Nachrichtenverwaltung im Anwendungskern 


Wie man in Bild 2 auch erkennen kann, besitzt der Kern 
einer Anwendung ein weiteres elementares Windows-Ele- 
ment, die Verwaltung der Fensternachrichten. Bis jetzt 
haben wir festgestellt, daß die Fensterfunktion auf den 
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Meldungsschleife 


Bild 3: Verteilung von Nachrichten innerhalb der Anwendung. 


Empfang von Nachrichten ihre Aktivitäten durchführt. 
Doch wie gelangen die Nachrichten zu der Fensterfunktion? 
Hier gibt es zwei unterschiedliche Wege: Erstens kann die 
Nachricht direkt an das Fenster gesandt werden (und damit 
an die dazugehörende Fensterfunktion) wo sie sofort verar- 
beitet wird. Eine zweite Möglichkeit besteht darin, die 
Nachricht an die Anwendung des Fensters zu senden und es 
dem Kern der Anwendung zu überlassen, die Nachricht an 
das entsprechende Fenster weiterzuleiten. Hierbei wird die 
angesprochene Anwendung nicht sofort die Nachricht bear- 
beiten, sondern erst, wenn sie die Kontrolle erhält und es 
der Anwendungskern für erforderlich ansieht. Die Nach- 
richten werden deshalb zunächst in einem Puffer (Applica- 
tion Message Queue) abgelegt. 

Im ersten Fall wird die Nachricht mit der Funktion 
SendMessage gesendet, im zweiten Fall mit PostMes- 
sage. Beide Übertragungsformen haben jeweils ihre Vor- 
und Nachteile und werden daher von Fall zu Fall verwendet. 
Auch Windows selbst benutzt beide Verfahren. Bei der Ent- 
wicklung einer Windows-Anwendung sollte man stets beide 
Möglichkeiten im Auge haben. Bei der Auswahl entscheidet 
sich beispielsweise, ob eine Anwendung bei der Eingabe 
»ruckt« oder sich »fließend« nach dem Benutzer richtet. 

Die Verwaltung der Fensternachrichten ist bei den mei- 
sten veröffentlichten Windows-Anwendungen die einzige 
Aufgabe, die (abgesehen von der Initialisierung) der 
Anwendungskern vornimmt. Es handelt sich hierbei um die 
bekannte Windows-Meldungsschleife. Eine Ausnahme 
macht das Programm MAZE.EXE aus einer früheren Aus- 
gabe des Microsoft System Journals [2]. Hier ist der Kern 
überwiegend damit beschäftigt, die Position des Balls neu 
zu berechnen. 

Die Meldungsschleife in der vorhandenen Form über- 
nimmt zwei Aufgaben: Einerseits übergibt sie für eine 
gewisse Zeit die Kontrolle an das System und andere ge- 
ladene Anwendungen durch Aufruf der Funktionen Get- 
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Bild 4: Aufbau der Dialogfeld-Fensterverwaltung 


Message, WaitMessage oder PeekMessage, anderer- 
seits meldet sie eine eingegangene Nachricht dem Fenster, 
dem die Nachricht gilt. Die Verteilung an verschiedene 
Fenster muß die Anwendung jedoch nicht selbst vorneh- 
men, dies wird ihr von der Systemfunktion DispatchMes- 
sage abgenommen (Bild 3). Die Anwendung hat jedoch die 
Möglichkeit, bestimmte Nachrichten abzufangen, zu verän- 
dern oder Synchronisierungen mit Abläufen im Kern vorzu- 
nehmen, Dies ist jedoch schon fortgeschrittene Windows- 
Programmierung und erfordert eine gewisse Erfahrung. 
DispatchMessage ruft die Fensterfunktion ähnlich wie 
SendMessage sofort auf. Keinesfalls darf der Kern eine 
Fensterfunktion direkt aufrufen. Dies führt aus Speicher- 
verwaltungsgründen zum Absturz /3]. 

Eine Anwendung kann mehr als ein Fenster besitzen, ja 
eigentlich sogar beliebig viele (bis der Speicher voll ist). 
Jedes angelegte Fenster weiß, zu welcher Anwendung es 
gehört und die Fensterverwaltung benutzt solche Informa- 
tion, wenn sie die Funktion PostMessage ausführt (ein 
Fenster kann nur genau einer Anwendung gehören). 

Nachrichten werden fast immer an Fenster geschickt, 
nur selten (mit PostAppMessage) an die Anwendung 
selbst. Das gilt auch für Nachrichten, die eigentlich gar nicht 
für ein bestimmtes Fenster gedacht sind, sondern mehr die 
Anwendung selbst betreffen, so die DDE-Kommunikation 
oder die Anfrage vom System, ob die Windows-Sitzung 
beendet werden darf. Dies unterstreicht noch einmal die 
wichtige Bedeutung des Fensters und der Fensterfunktion in 
Windows. 


Tochterfenster bringen Übersicht 


Wie in der Einleitung erwähnt, besitzen fast alle Beispiele 
des SDK und auch alle bisher im Microsoft System Journal 
aufgeführten Programme nur ein einziges explizit verein- 
bartes Fenster, das Anwendungsfenster. Bei einfacheren 
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Es ist schon bemerkenswert, was Sie mit FormlMaster in 
weniger als einer Stunde auf Ihrem Bildschirm zaubern 
können. Zum Beispiel ein komplexes Formular — nach 
allen Regeln der Kunst gestaltet und am Bildschirm kom- 
plett ausfüllbar. Denn von der Erstellung bis zur Verwal- 
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Bild 5: Modell der Unterklassentechnik 


Anwendungen ist dies auch vollkommen ausreichend, doch 
bei komplizierten Programmen ist die Verwaltung beim 
(Neu-)Zeichnen des Fensterinhalts doch ziemlich groß und 
die Fensterfunktion wird stark aufgebläht. Hier bietet sich 
an, weiterhin ein einziges großes Anwendungsfenster zu 
haben, dessen Zeichenfläche aber in mehrere kleinere Fen- 
ster aufzuteilen und diese unabhängig voneinander in ihren 
einzelnen Fensterfunktionen zu zeichnen. Diese neuen Fen- 
ster enthalten natürlich keine Rahmen, da der Inhalt des 
Anwendungsfensters weiterhin als homogene Einheit dem 
Benutzer präsentiert werden soll. Die Fenster müssen fest 
mit dem Anwendungsfenster verbunden sein, wird letzteres 
bewegt, sollen sich die Fenster schließlich mitbewegen. 
Muß ein Teil des Anwendungsfensters neu gezeichnet wer- 
den, müssen auch die in diesem Teil liegenden Fenster eine 
Aufforderung zum Neuzeichnen erhalten. 

Die Fensterverwaltung von Windows stellt dem Pro- 
grammierer ein Konzept zur Verfügung, welches tatsächlich 
obigen Anforderungen (und einigen weiteren) genügt. Die 
Windows-Entwickler wählten hierzu den Begriff des Toch- 
terfensters (im Original Child Window). Ein Tochterfenster 
steht im Zeichenbereich eines anderen (Vater-)Fensters. 
Das Vaterfenster kann beliebig viele Tochterfenster besit- 
zen, diese können sich überlappen oder nebeneinander ste- 
hen. Bei der Mehrfach-Dokumentenschnittstelle (Multi- 
Document-Interface) [1] werden sogar Tochterfenster ver- 
wendet, die Rahmen zum Verschieben und Vergrößern 
besitzen wie normale Anwendungsfenster. Folgendes sind 
die wesentlichen Eigenschaften von Tochterfenstern: 
= Sie können ein beliebiges Aussehen haben, also auch 

Rahmen oder Titelleiste besitzen, dürfen aber keine 

Menüleiste haben. 
= Sie müssen innerhalb des Zeichenbereichs des Vaterfen- 

sters stehen, überstehende Teile werden abgeschnitten 

(clipping). Wird das Vaterfenster zum Sinnbild ver- 

kleinert, werden alle seine Tochterfenster unsichtbar. 


70 Microsoft System Journal März/April 1989 


= Ein Tochterfenster existiert nur solange wie das Vater- 
fenster existiert. Wird das Vaterfenster vernichtet, wer- 
den auch alle Tochterfenster vernichtet. 

= Das Vaterfenster überwacht das Neuzeichnen der Toch- 
terfenster, indem es diese mit den dazu benötigten 

Nachrichten versorgt. Bei Überlappungen von Tochter- 

fenstern existiert eine vom Programmierer beinflußbare 

Zeichenlogik wie die überlappten Fensterteile gezeich- 

net werden. Wird das Vaterfenster selbst gezeichnet, 

werden dabei die Tochterfenster ausgespart. 

= Wird die Maus bewegt, wird vom Vaterfenster automa- 
tisch dem Tochterfenster die Nachricht zugesandt, auf 
das im Augenblick die Maus zeigt. Mit Tochterfenstern 
lassen sich somit auf höchst einfache Weise Anwendun- 
gen realisieren, bei denen das Anklicken bestimmter 

Felder spezifische Aktionen bewirkt. Wird ohne Toch- 

terfenster gearbeitet, muß jedesmal in der Anwendung 

explizit aus der Mausposition algorithmisch das entspre- 
chende Feld berechnet werden. 

= Tochterfenster sollten im Normalfall eine Identifizie- 
rungs-Nummer (Id) besitzen, mit der sie angesprochen 
werden. Da der Wert vom Programmierer beliebig 
gewählt werden kann (im Gegensatz zum Fensterbezug 

(Handle), dessen Wert von Windows vorgegebenen 

wird), kann er auch als Index in Felder usw. verwendet 

werden. 

Tochterfenster können auf verschiedenste Art benutzt 
werden. Auch das MS-DOS-Fenster wurde mit Tochterfen- 
stern realisiert. Wie der Leser weiß, wird in diesem Fenster 
eine Liste der verfügbaren Laufwerke, der aktuelle Pfad 
und die Tabelle der Dateien im aktuellen Verzeichnis ange- 
zeigt. Anstatt nun ein einziges großes schwerfälliges Fenster 
für die Darstellung zu wählen, hat man die drei verschie- 
denen Darstellungen in drei verschiedene Tochterfenster 
verteilt, deren Vaterfenster das MS-DOS-Fenster ist. Hier- 
bei kann der Benutzer auf Anhieb nicht sehen, daß es tat- 
sächlich drei verschiedene Fenster sind, denn die verwen- 
deten Tochterfenster besitzen keine Rahmen und können 
auch nicht vom Benutzer verschoben werden. 


Jedem Fenster seine Fensterklasse 


Nachdem wir nun wissen, welche Bedeutung Fenster für 
eine Anwendung besitzen, wird es Zeit, sich mit der Entste- 
hung eines Fensters zu befassen. »Kein Problem«, werden 
manche sagen, »das geht mit CreateWindow«. Doch das 
ist nur die halbe Wahrheit. Mit CreateWindow wird ein 
Fenster angelegt, dazu muß man jedoch dessen Fenster- 
klasse kennen. Diese wird vorher mit der Funktion Regi- 
sterWindowClass definiert, mit irgendwelchen merkwür- 
digen Parametern ... 

Ein weiteres Mal wurde blind etwas aus Beispielen über- 
nommen, ohne daß man sich eigentlich genauer damit be- 
schäftigt hätte. Dabei ist das Konzept der Fensterklasse 
eigentlich eine der interessanten und mächtigsten Techni- 


WNDCLASS.IpszClassName 
ist der Name der Klasse, angegeben als mit 0 beendete 
Zeichenkette. 

WNDCLASS.style, Index GCW_STYLE 
ist ein Bitfeld, in dem folgende Flags gesetzt werden 
können: 
CS_BYTEALIGNWINDOW 
Das Fenster beginnt in X-Richtung so, daß es an einer 
Byte-Grenze im Bildschirmspeicher beginnt. Durch eine 
entsprechende relative Ausrichtung der Textausgabe- 
oder Punktbild-Positionen innerhalb des Fensters (Viel- 
faches von 8) läßt sich der Fensteraufbau erheblich be- 
schleunigen. 
CS_BYTEALIGNCLIENT 
Wie CS_BYTEALIGNWINDOW, die Byte-Grenzen- 
Ausrichtung bezieht sich jedoch auf den Fensterinhalt. 
Sinnvoll bei Fenster, deren Rahmenbreite nicht als Kon- 
stante vorgegeben ist. 
CS_SAVEBITS 
Das Punktbild (Bitmap) des kompletten Fensterinhalts 
wird gesichert. Dadurch läßt sich das Neuzeichnen bei 
der WM _PAINT-Nachricht erheblich beschleunigen. 
Bei größeren Fenstern wird jedoch sehr viel Speicher 
belegt. 
CS_NOCLOSE 
Der SCHLIESSEN-Befehl im Steuermenü ist gesperrt. 
CS _NOKEYCVT 
Nicht dokumentiert, Bedeutung unklar. 
CS_PARENTDC 
Jedes Fenster erhält den Zeichenkontext (Display Con- 
text) des Vaterfensters. 
CS_CLASSDC 
Die Klasse enthält einen eigenen Zeichenkontext, d.h. 
alle Fenster dieser Klasse teilen sich einen gemeinsamen 
Zeichenkontext. 
CS_OWNDC 
Jedes Fenster erhält seinen eigenen Zeichenkontext 
(Display Context). Diese Option ermöglicht ein ein- 
faches Verwalten der Zeichenwerkzeuge (Zeichensatz, 
Strichbreite), benötigt aber ca. 800 Bytes zusätzlich pro 
Fenster. 
CS_OEMCHARS 
Die Funktion TranslateMessage wandelt virtuelle Tasten 
nicht in ANSI-Zeichen, sondern in OEM-Zeichen um. 
CS_DBLCLKS 
Bei Doppelklick Meldung an das Fenster, sonst nicht. 
CS_NOKEYCVT 
Nicht dokumentiert, Bedeutung unklar. 
CS_HREDRAW 
Wird das Fenster in der Höhe geändert, wird der 
gesamte Bildschirminhalt für ungültig erklärt. Wichtig 
für Fenster, die den Inhalt größenabhängig zeichnen 
(zum Beispiel die Anwendung UHR). 


CS_VREDRAW 
Wird das Fenster in der Breite geändert, wird der 
gesamte Bildschirminhalt für ungültig erklärt. Anwen- 
dung wie bei CS HREDRAW. 

WNDCLASS.hInstance, Index GCW_HMODULE 
gibt den Instanzbezug der Fensterklasse an, das heißt zu 
wessen Modul die Fensterklasse gehört. 

WNDCLASS.IpfnWndProc, Index GCL_WNDPROC 
ist die Initialisierungs-Adresse der Fensterfunktion für 
alle Fenster der Klasse. Dieser Wert wird bei Create- 
Window dem Fenster zugewiesen (Index 
GWL_WNDPROC). 

WNDCLASS.cbClsExtra, Index GCW_CBCLSEXTRA 
gibt an, wieviel Bytes beim Anlegen der Fensterklasse 
zusätzlich zum Ablegen von Fensterklassen-Daten reser- 
viert werden sollen. Im Gegensatz zu GCW_CBWND- 
EXTRA ist dieser Wert nicht sehr nützlich und sollte 
daher im allgemeinen 0 sein. 

WNDCLASS.cbWndExtra, Index GCW_CBWNDEXTRA 
gibt an, wieviel Bytes beim Anlegen eines Fensters 
zusätzlich zum Ablegen von Fenster-Daten reserviert 
werden sollen. In dem angelegten Bereich können lokale 
Fensterdaten abgelegt werden (siehe 2. Teil dieses Arti- 
kels). Wenn pro Anwendung nur ein Fenster pro Klasse 
angelegt wird (wie bei dem Hauptfenster der Anwen- 
dung), ist dieser Wert normalerweise 0. 

WNDCLASS.hbrBackground, Index GCW_HBRBACK- 
GROUND: bezeichnet die Farbe oder das Farbmuster 
(Brush) des Fensterhintergrunds. Dieser Wert wird 
verwendet, wenn die Nachrictt WM_ERASEBKGND 
das Fenster löscht und dieses Löschen nicht explizit die 
Fensterfunktion durchführt. 

WNDCLASS.hCursor, Index GCW_HCURSOR 
ist der Bezug auf den Mauszeiger des Fensters. Immer 
wenn der Benutzer die Maus in den Fensterbereich ver- 
schiebt, wird dieser Zeiger angezeigt. Wird kein Bezug 
angegeben (NULL), muß die Fensterfunktion jedesmal 
den Mauszeiger selbst setzen, sobald sie eine Nachricht 
erhält, daß die Mausposition innerhalb ihrer Fenster- 
grenzen liegt. 

WNDCLASS.IpszMenuName, Index GCL MENUNAME 
ist der Name oder die Ressourcen-Nummer des Menüs, 
das bei der Anlegung eines Fensters diesem als Initiali- 
sierung zugewiesen wird. Wird kein Menü angegeben, 
erhält entsprechend das Fenster zunächst kein Menü. 
Tochterfenster können kein Menü besitzen. 

WNDCLASS.hlIcon, Index GCW_HICON 
ist der Bezug auf das verwendete Sinnbild. Braucht nur 
angegeben zu werden, wenn das Fenster auf Sinnbild- 
größe verkleinert werden kann. Wird kein Sinnbild 
angegeben, muß ggf. das Fenster sein eigenes Sinnbild 
zeichnen (wie die Anwendung UHR.EXE). 


Tabelle 1: Die Fensterklassen-Parameter 
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ken, die Windows dem Programmierer zur Verfügung stellt. 
Deshalb wollen wir uns im weiteren detailliert mit Fenster- 
klassen beschäftigen. 

Jedes Fenster besitzt bestimmte Eigenschaften, die 
durch Parameter beschrieben werden. Dazu gehören neben 
der Größe und dem Aussehen des Fensters auch die Besitz- 
verhältnisse und die Adresse der Fensterfunktion. Anstatt 
nun diese Parameter bei jedem Anlegen eines Fensters 
erneut anzugeben, faßt man einige Eigenschaften zu einer 
Fensterklasse zusammen und definiert zunächst diese. Sie 
besitzt im Gegensatz zu einem Fenster einen Namen und 
die Definition erfolgt mit RegisterWindowClass. Die 
Parameter einer Fensterklasse sind in Tabelle 1 aufgeführt 
und kurz beschrieben. Andere Parameter sind dagegen dem 
Fenster direkt zugeordnet. Diese Parameter sind entspre- 
chend in Tabelle 2 beschrieben. 

Warum haben die Entwickler von Windows nun zwi- 
schen Fenstern und Fensterklassen unterschieden? Dies hat 
mehrere Gründe: 


= Oft werden mehrere Fenster angelegt, aber die Eigen- 
schaften der Fenster untereinander unterscheiden sich 
nicht stark, zum Beispiel nur in Position, Größe und 
Fensterinhalt. Doch dann können sich alle Fenster einer 
Klasse eine gemeinsame Fensterfunktion teilen oder 
besitzen diesselbe Hintergrundfarbe oder Mauszeiger 
(Cursor). Es wäre Speicherverschwendung, würden 
gemeinsame Fensterdaten mehrfach gehalten. 

= Es gibt vordefinierte Fensterklassen (Static, Button, 
Edit, ListBox, ScrollBar), die von Windows angelegt 
wurden und dazu verwendet werden, komplizierte aber 
häufig benötigte Dialogelemente zu implementieren. So 
kann beispielsweise durch Verwendung der EDIT- 
Klasse mit einfachen CreateWindow-Aufrufen sowohl 
die Zeileneingabe als auch ein kompletter Texteditor 
realisiert werden. Der Programmierer braucht das Rad 
nicht ständig neu zu erfinden. 

= Klassen von in Anwendungen häufig benötigten Fen- 
stern werden unabhängig von der Anwendung der Fen- 
ster entwickelt und implementiert. Die Implementierung 
des Fensters (Initialisierung und Fensterfunktion) kann 
in eine anbindbare Bibliothek (dynamic link library, 
DLL) verlagert werden und erweitert damit die Liste 
der vordefinierten Fensterklassen. 

= Selbstdefinierte Fenster kann man auch in Dialogfeldern 
(Dialog boxes) darstellen. Dazu wird einfach der Klas- 
senname bei der Beschreibung des Dialogfelds in der 
Ressourcen-Datei als Argument der CONTROL-An- 
weisung angegeben. Man ist nicht länger auf die Stan- 
dard-Dialogelemente in Dialogfeldern angewiesen. 


Fensterklassen sind hervorragend dazu geeignet, 
Anwendungen zu strukturieren. Die Entwicklung eines Fen- 
sters geschieht bei der Spezifikation der Klasse. Es wird ein 
Satz von Nachrichten für das Fenster zusammengestellt, mit 
denen der Fensterinhalt verändert werden kann. 
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Index GWL_ WNDPROC 
ist die Adresse der Fensterfunktion. Bei CreateWindow 
wird ihr der Adressenwert der Fensterklasse zugewiesen 
(Index GCL_WNDPROC). Der Wert wird bei Fenster- 
Unterklassen geändert. 

Index GWW_HINSTANCE 
gibt den Instanzenbezug des Fensters an, das heißt, zu 
welchem Modul das Fenster gehört. Dieses muß nicht 
zwangsläufig dasselbe Modul sein, das die Fensterklasse 
angelegt hat (Index GCW _HMODULE). 

Index GWW HWNDPARENT 
ist der Bezug auf das Vaterfenster des Fensters. Ein 
Wert von O0 bezeichnet, daß das Fenster auf oberster 
Ebene liegt und nur den Bildschirmhintergrund als 
Vater hat. Tochterfenster haben hier einen von 0 ver- 
schiedenen Wert. 

Index GWW_HWNDTEXT 
ist der Bezug auf den Fenstertext. Doch dieser Bezug 
darf nur von Windows intern verwendet werden. Um 
den Fenstertext zu erhalten oder zu ändern, müssen die 
Funktionen GetWindowText und SetWindowText ver- 
wendet werden. 

Index GWW _ID 
ist die Bezeichnung eines Tochterfensters. Sie wird zur 
Unterscheidung mehrerer Fenster einer Klasse verwen- 
det, zum Beispiel beim Versenden von Nachrichten an 
ein bestimmtes Fenster. Insbesondere wird dieser Wert 
innerhalb von Dialogfeldern (Dialog Boxes) verwendet. 

Index GWL_STYLE 
ist der Stil des Fensters. Bei diesem 32-Bit-Wert sind 
nur in den oberen 16 Bits die allgemeinen Fensterstile 
(Rahmenstil, Tochterfenster-Verhalten usw.) enthalten. 
In den unteren 16 Bits können dagegen klassenspezifi- 
sche Stile angegeben werden. Sowohl der Fensterstil als 
auch der Stil der vordefinierten Fensterklassen ist in /1] 
bei der Beschreibung der Funktion CreateWindow aus- 
führlich beschrieben. Beim Entwickeln eigener Fenster- 
klassen sollten wichtige Darstellungsstile in den unteren 
16 Bits definiert werden, da dann diese Stile auch bei 
einer Dialogfeld-Definition in der Ressourcen-Datei 
festgelegt werden können. 


Tabelle 2: Die Fenster-Parameter 


Anschließend wird die Fensterfunktion implementiert, 
die diese neuen Nachrichten und die Standardnachrichten 
(Größe, Neuzeichnen, etc.) verarbeitet. Nun ist die neue 
Fensterklasse fertig und kann genauso verwendet werden 
wie die vordefinierten Fensterklassen EDIT, BUTTON etc. 
Die Anwendung der neuen Klasse erfolgt genauso einfach 
wie bei den vordefinierten Klassen, entweder explizit mit 
CreateWindow oder implizit durch Verwendung in Dialog- 
feld-Definitionen. 


PRREBRBBRRRBBRRRBRRRBBBRRERERRBBERERBBRRBBEHHBRRRBBRBBBRBBRRRBE 
---- SUBCLASS ---- MS-Windows Application 


Eerereeememenmsnemmmemsmnsmnueseemesnsegesnenungeggseeneenenenen 


This MS-Windows application is a small program for the 
demonstration and study of the Windows programming technique of 
window subclassing. 


Copyright 1988 by 
Marcellus Buchheit, Buchheit software research 
Zaehringerstrasse 47, D-7588 Karlsruhe 1 
Phone (8) 721/37 67 76 (West Germany) 


Release 1.00 of 88-Dec-#7 --- All rights reserved. 
HR 


IH N NIEDER EB DEE EEE NEBEN EEE BENENNEN RRRRORBRREE/ 


/* define/undefine non-debugging option name */ 
#undef NDEBUG 


#define NOMINMAX 
Zinclude <WINDOWS.H> 
#include "DEFS.H” 


/* further C standard headers */ 
include <stdlib.h> 


/* window function parameter macros */ 
#define P2LO LOWORD(ulP2) 
#define P2HI HIWORD(ulP2) 


[PR BAR N AR NENNEN BIENEN BEDIENEN 
Application Variables 
2.23 


EEE HEINE NEE NIE NEE: 
/%* application name #/ 
char *rzAppName = "SUBCLASS"; 


/* handle to application instance */ 
HANDLE hiMain; 


FARPROC rfwSubEdit; 
FARPROC rfwOrgEdit; 
FARPROC rfdLine; 


[ReRORBBRRERERBRBBRBBREREIBBIRREBIBEBBHRBRISBRIBEBEBBEBRBBBEBBRREKEIHHEEEN 


"EDIT" Subelassing function 


EEE EEE EEE EEE NEE HEN ENEEE/ 


[Ren BE MENEARN AR BE BEER EERBENEBENEREBEEEEDEEEBE DENN EER EI DEBE DE EEEE 
fwSubEdit 

#44 Subclassing window function #47 

This function adds a overwrite option and 

the "Copy” command to the "EDIT" class. 


Parameters: 
standard message data (see fwMain) 
Return: 


standard window function return value. 
EEE EIERN EEE HB / 


LONG FAR PASCAL fwSubEdit(HWND hw,WORD iMsg,WORD uP1, 
DWORD ulP2) 
{static BOOL bOverkrite=FALSE; 
BOOL bShiftDown; /* TRUE if SHIFT pressed #/ 
BOOL bCtrlDown; /* TRUE if CTRL pressed #/ 
LONG vRetValue; 
DWORD uSelRange; 


Listing 1: Das Programm SUBCLASS.C 


switch (iMsg) 
{ in sElroous: 
focus: clear overwrite mode */ 


AO EEHELLERFALSE: break; 
case WM KEYDOWN: 
if (ulP2&(1<<29)) break; /* don't consume system key */ 
bShiftDown=GetKeyState(VK SHIFT)>>15; 
bCtr1Down=GetKeyState(VK_CONTROL)>>15; 
if (uP1==VK_INSERT) 
{/* "Ins": analyse context %*/ 
if (bCtrlDown) 
{/* CTRL+INS: set selection into clipboard */ 
iMsg=WM_COPY; break; 


else if 
(tbCtrlDown &% !bShiftDown && 
GethindowLong(hw,GWL_STYLE)&ES_MULTILINE 


) 
{/* toggle overwrite mode */ 
bOverkrite=!bOverkrite; 
if (tbOverkrite) 
{/* exact one character selected => unselect this */ 
uSelRange= 
CallWindowProc(rfworgEdit,hw,EM GETSEL,®,BL); 
if (HIWORD(uSelRange)- OWORD(uSelRange)==1) 
{/* select no character, 
don’t change caret location */ 
CallWindowProc 
(r en SETSEL, 
e ONG(LOKORD(uSelRange) ‚LOWORD(uSelRange) ) 


Y/e if 
} ir ®/ 
vRetValue=@L; goto CheckSel; /* key is consumed */ 
} /R if */ 
y /e if w/ 

} /* switch */ 
vRetValue=CallWindowProc(rfwOrgEdit,hw,iMsg,uP1,ulP2); 
Check$Sel: 
if (böverkrite && 

(1Msg==WM_KEYDORN | 1 1Msg==WM_CHAR| | 1Msg==WM_LBUTTONUP) ) 

{/* overwrite mode: 

check if at least one character is selected */ 
uSelRange=CallWindowProc(rfwörgEdit,hw,EM_GETSEL,8,@L); 
if (LOWÖRD(uSe Range )==HIHORD(USelRänge)) 
{/* select location character */ 
/* normally: caret at left of selection */ 
int iStart=1,iEnd=ß; 
if (iMsg==WM_KEYDOWN &%& uP1==VK_RIGHT &%& bShiftDown) 
{/* ar ae selection to right: set caret at right %*/ 
1Start=-1; 
Y/R it ®/ 
CallWindowProc 
re SETSEL, 
ß, LONG(LOWORD(uSelRange)+iStart,,LOWORD(uSelRange)) 


); 
y /R if %®/ 
I/ır W/ 
return vRetValue; 
} /* SwSubEdit() %/ 


[PR ENEHENEEHENEENENENEENENENENENE NENNEN NENEBNENENENENENENEBNEBEEBNEE BEN BENEENE NENNEN  BENBNE 


Dialog box functions 
REDE BIENEN IE NENNE / 


[ PR REMEMBER NENNE EEE EEE EEE EBENEN EBENE NEN NEBEN EN 
fdLine 


#44 Dialog Box function #74 
This function processes any messages received 
by the DBX_LINE dialog box. 


Parameters: 

standard message data (see fwMain) 
Return: 

standard dialog box function value. DialogBox() returns TRUE. 
ANNIE 


AHHEREIREIEEIERNIEEIE/ 


Listing 1: (Fortsetzung) 
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BOOL FAR PASCAL fdLine(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2) 
{int i; 


switch (iMsg) 
{case WM_INITDIALOG: 
/* subwindowing of IDLINE "edit" window %/ 
SetWindowLon 
(GetDl TtenChw, IDLINE) ‚GäL_HNDPROC, (LONG)rfwSubEdit); 
return TRUE; 
case WM COMMAND: 
if (uP1==IDOK) 
{/* close dialog box */ 
EndDialog(hw, TRUE) ; 
return TRUE; 
YA itW/ 
break; 
} /* switch #/ 
return FALSE; 
} /* fdLine() */ 


/ PaRHMEBREEN EEE N 


Main Window function 
EEE INA IE EBENEN NR BB 3 NER / 


LONG FAR PASCAL fwMain(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2) 


{switch (iMsg) 

{case WM ATE: 
/* set application window handle */ 
hwMain=hw; 
return BL; 

case WM SIZE: 
/* set new size of EDIT client window */ 
MoveWindow(hwEdit,8,9,P2LO,P2HI,FALSE); 
return @L; 

case KM 


COMMAND: 
if (uP1==CMD LINE) 
{/* dialog box for testing line */ 
DialogBox 
(hiMain,MAKEINTRESOURCE(DBX_LINE) ,hwMain,rfdLine); 
SetFocus(hwEdit); /* focus to edit field again */ 


Destroykindow(hw) ; 
return BL; 
case WM _DESTROY: 
PostQuitMessage(2); return OL; 
} /* switch */ 
return DefkindowProc(hw, iMsg,uP1,ulP2); 
} /* SwMain() */ 


[#3 EBENEN EB NEED EEE NEE 


-- Window dependent initialization (one for all instances) -- 
EEE NENNEN / 


[39% ce BENENNEN INNEN EEE 
CreateClass 


The classes of all application specified windows are 
registered. 

Parameters: 

none 

Return: 


TRUE if all classes created. 


FALSE if any error during creation (memory error). 
EEE EINE NEE NEE NEE BEI BRIEF IEIHIIRIEIHIEISIIEIIRIINAEIEIEIERI 


BOOL CreateClass(VOID) 
{HNDCLASS wndclass; 


Listing 1: (Fortsetzung) 
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/# =-- Create window class of Application --- */ 


a ee a a 
wndelass.hInstance=hiMain; 

wndclass.1pfnkndProc=fwMain; 
wndclass.hCursor=LoadCursor (NULL, IDC_ARRON) ; 
wndclass.hbrBackground=GetStockObject(WHITE BRUSH) ; 
wndelass.style=CS HREDRAWICS WICS_BYTEALIGNCLIENT; 
wndclass.hIcon=NULL; 
wndclass.1pszMenuName=MAKEINTRESOURCE (MNU_MAIN); 
wndclass.cbClsExtra=8; wndclass.cbWndExtra=f; 

/* register window, return if error */ 

if (tRegisterClass(&wndclass)) return FALSE; 

} /* CreateClass() %*/ 


PR NEE EEE EINEN NENNEN IRINA IRINA 


-- Instance dependent initialization (for every instance) -- 
DR EEE BEE EEE / 


REKEN EN RR ENDE IIND EDER EEE EN 


SetGlobalProcedure 
All entry procedures (called by Windows systems) get a calling 
instance here. This is done by the MakeProcInstance() function. 


Parameters: 

none 

Return: 

TRUE is returned if all procedures data set. 


FALSE if returned if any error occured (memory too small). 
PIENNEDEDEEDERDELEDELEDTEEDEEN EEE E28 202222 2272157272727 2 02720227 


BOOL SetGlobalProcedure(VOID) 


{rfdLine=MakeProcInstance(fdLine,hiMain); 

if (rfdLine==NULL) return FALSE; 
rfwSubEdit=MakeProcInstance( (FARPROC) fwSubEdit,hiMain); 
if (rfwSubEdit==NULL) return FALSE; 

return TRUE; 

} /* SetGlobalProcedure() */ 


WIEDER INNEN ENDEN NEBEN 
CreateApphWindow 


All global existing windows are created by this function. 


Paraneters: 

none 

Return: 

TRUE is returned if all data read, otherwise FALSE 


(memory too small). 
EBD BEENDEN NENNE ERBEN NENNE / 


BOOL CreateAppkindow(VOID) 


{/* application’s window, return if error */ 

if (tCreateWindow 
ne Subclassing Demonstration”, 
WS RLAPPEDWINDOW,CW USEDEFÄULT,@,CW_USEDEFAULT ‚Ö, 
s ERTL FONRAN ME. 


) 
return FALSE; 
hwEdit=Createhindow 
("EDIT” NULL,WS CHILDIWS VISIBLE}ES MULTILINEIWS_VSCROLL] 
WS_HSCROLLIES_ÄUTOHSCROLL |ES_AUTOVSCROLL, 
8,2,8,8,hwMain, IDEDIT,hiMain, NULL 


); 
if (hwEdit==NULL) return FALSE; 
/* redirect "EDIT” class function %/ 
a 
(FARPROC)SetWindowLong(hwEdit ,GKL_WNDPROC, (LONG)rfwSubEdit); 
return TRUE; 
} /* CreateAppWindow() */ 


Listing 1: (Fortsetzung) 


[WBRRBBBBBEBBBBBRBIBEBEIBEIBEBEREEERBEIBERDEEEGEREENIRIBIIE 
InitInstance : The main init module entry point 477 
The complete initialization of a new instance of the appli- 
cation window. If no previous instance exists, the application 
window is initialized and the common data for all instances 
are created. Otherwise, common data are copied from the 
previous instance to the new instance. All individual data in 
the instance data segment are initialized. If memory is too 
small, a error message box is displayed and FALSE is returned. 
Paraneters: 

hiNew is the handle to the new instance of window. 

hiPrev is the handle to the first instance of window. 
rzCndLine points to the command line buffer. 

Ri: pers is the entry style of window for Showkindow(). 
eturn: 

TRUE is returned if initialization complete, 


otherwise FALSE (memory too small). 
ERREINENRINREANEBNARARANENN N INNNNNNN/ 


BOOL rg hiNew,HANDLE hiPrev, 
PSTR rzCadLine, int vCadShow) 


{hiMain=hiNew; /* set instance global */ 
if (thiPrev) 
{/* initialize first instance, exit if error %/ 
ya ee) goto MenError; 
”* 
/* create procedure instance addresses %#/ 


if DEE N ee goto MemError; 
/* create all global application windows */ 
if (1öresterpphinden() u MenError; 

/* show created main win 

ShowWindow(hwMain, vCmdShow) ; Updateilindowhufiain):; 
SetFocus(hwEdit); /#* focus to edit field */ 
return TRUE; 

MenError: 

/%* error: memory too small */ 

return FALSE; /* return with error %*/ 

} /* InitInstance() %*/ 


0 0 IRRE NENNE 
Main function 


UI EHE MEINEN RHEIN / 
WORD PASCAL WinMain(HANDLE hiNew,HANDLE hiPrev, 
ense LPSTR rzCmdLine,int vCmdShow) 
wm; 


/* Initialize (window and) instance, return if error */ 
if (tInitInstance(hiNew,hiPrev,rzCmdLine, vCndShow)) 
return FALSE; 
IR ——— application execution loop --- */ 
while (GetMessage(&m,NULL,9,2)) 
{TranslateMessage (&m); Dispatchlessage (&m); 
} /* while #/ 
return wm.wParan; 
} /* WinMain() %/ 


Listing 1: (Ende) 


CC=CL >$%*,ERR -c -AS -Gsw -Od -W2 -Zdp $*.C 


SUBCLASS.RES: SUBCLASS.RC DEFS.H 
RC -r $* 


SUBCLASS.OBJ: SUBCLASS.C DEFS.H 
SETDEBUG $* ON 


$(CC) 


SUBCLASS.EXE: SUBCLASS.OBJ SUBCLASS.RES SUBCLASS.DEF 
re $#/A:16,/L1/M, „SLIBW+SLIBCEW/NOD, $* 


Listing 2: Die Make-Datei SUBCLASS.MD 


[MEHR EENENENNENENEENE 


--- SUBCLASS ---- MS-Windows lication 
Resource file 
Copyright 1988 by 
Marcellus Buchheit, Buchheit software research 
Zaehringerstrasse 47, D-75688 Karlsruhe 1 
Phone (8) 721/37 67 76 (West Germany) 


All rights reserved --- Release 1.80 of 88-Dec-97 
ER EN N / 


#include <STYLE.H> 
include "DEFS.H” 


> application’s menu specification 
%* 


MNU_MAIN MENU BEGIN 
MENUITEM "Zeile”,CMD LINE 
END 


Ser, boxes specification 
* 


DBX LINE DIALOG 25,28,148,48 

CAPTION "Zeilentest” 

STYLE WS_CAPTIONIWS_POPUP 

BEGIN 

CONTROL "",IDLINE,”edit”,ES_AUTOHSCROLL |ES_LEFTIWS_BORDER| 
WS "TABSTOPINS_ CHILD, ‚4,4,148,12 

CONTROL "&Ök” ,IDOK,”"button”,WS _CHILDINS_ TABSTOP |WS_GROUP | 
BS DEFPUSHBUTTON, 49, '26,: 58,14 

END /* DBX_ LINE ®/ 


Listing 3: Die Ressourcen-Datei SUBCLASS.RC 


/* menu commands */ 
108 


588 
908 


DLINE 
#define IDEDIT 2881 


Listing 4: Gemeinsame Definitionen von SUBCLASS.RC 
und SUBCLASS.C 


NAME SUBCLASS 

REALMODE 

EXETYPE WINDOWS 

DESCRIPTION "Window subclassing deno' 
STUB '..\WINSTUB.EXE’ 

CODE MOVABLE DISCARDABLE SHARED 
DATA MOVABLE MULTIPLE 


HEAPSIZE 2848 
STACKSIZE 4896 


fwSubEdit @2 
fdLine 83 


Listing 5: Die Linker-Definitionsdatei SUBCLASS.DEF 
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Trennung zwischen Entwicklung und 
Anwendung von Fenstern 


Mit den Fensterklassen hat Microsoft die allgemeine 
Modul- oder Klassentechnik von Programmiersprachen wie 
Modula II /8] oder C++ /9] auf Fenster übertragen. Die 
seit langem bekannten Vorteile dieser Technik können 
damit auf die Entwicklung von Windows-Anwendungen 
Einfluß finden, auch wenn bis heute (leider) noch kein 
C+ +-Compiler Windows unterstützt. 

Beim Anlauf eines größeren Software-Projekts ist es oft 
noch nicht ganz klar, wie die einzelnen Dialogelemente am 
ergonomisch günstigsten plaziert werden. Die Objekte 
selbst sind dagegen entweder von früheren Projekten schon 
vorhanden oder in ihrer Form und Funktion bereits zu 
einem frühen Projektstadium festlegbar. Somit kann die 
Entwicklung dieser Objekte schon sehr früh beginnen. Bei 
einer sauberen Planung steckt die Hauptarbeit in der Ent- 
wicklung und Implementierung der Dialogelemente, nicht 
aber in der Plazierung der Objekte oder der Verarbeitung 
der Nachrichten dieser Objekte, ihrer Anwendung also. Wie 
einfach lassen sich die vordefinierten Fensterklassen ver- 
wenden, aber welche Komplexität steckt beispielsweise 
hinter der Implementierung der Klasse LISTBOX. Auch 
kann die Entwicklung eines Projekts aufgeteilt werden in 
Mitarbeiter, die Fensterklassen entwickeln und mehr 
systemorientiert arbeiten, und Mitarbeitern, die Fenster mit 
diesen Klassen anlegen und dabei mehr anwenderorientiert 
und ergonomisch denken. 

Weiter oben habe ich erwähnt, daß das MS-DOS-Fen- 
ster drei Tochterfenstern besitzt. Sie tragen die Klassen- 
namen Disk, Dir und Path. Es ist einsichtig, daß Microsoft 
diese Fensterklassen auch für andere Aufgaben verwenden 
kann oder leicht das Aussehen des MS-DOS-Fensters durch 
eine andere Anordnung der Fenster verändern kann. Wie 
kompliziert wäre dagegen das alles, hätte man versucht, das 
MS-DOS-Fenster als ein riesiges Fenster ohne Tochterfen- 
ster oder ohne mehrere Fensterklassen zu implementieren! 


Dialogfelder: Ein Fenster mit Tochterfenstern 


Mit Dialogfeldern kann man mit wenig Aufwand Dialog- 
elemente in Fenstern anordnen, entweder durch Angabe 
der Elementgröße und -position in der Ressourcen-Datei 
oder interaktiv durch Verwendung des Programms DIA- 
LOG.EXE. Doch was sind eigentlich Dialogfelder? Nun, 
das Dialogfeld selbst ist ein gewöhnliches Fenster und die 
Dialogeinträge sind die Tochterfenster dieses Dialogfen- 
sters. Mit dem DIALOG-Eintrag in der Ressourcen-Datei 
beschreibt man die Art und Größe des Dialogfensters und 
mit den CONTROL-Einträgen (oder CTEXT, RADIO- 
BUTTON etc.) die Art, Größe und Position der einzelnen 
Tochterfenster. Die Art der Dialogelemente wird dabei 
einerseits durch den Klassennamen und andererseits durch 
den Fensterstil vorgegeben. Beim Aufruf des Dialogfelds 
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erzeugt die Dialogfeld-Verwaltung durch sukzessiven 
CreateWindow-Aufruf die spezifizierten Fenster. Nach- 
dem Sie nun wissen, daß jedes Fenster einer Klasse ange- 
hört, sind Sie sicherlich neugierig, zu welcher Klasse denn 
ein Dialogfenster gehört. Nun, alle Dialogfenster gehören 
der Fensterklasse mit dem Namen »#32770« an. Die Fen- 
sterfunktion dieser Klasse geht beim Erhalten der 
WM_CREATE-Nachricht die Liste der Tochterfenster durch 
und legt diese an. Anschließend verwaltet sie die Adressie- 
rung der einzelnen Felder über die Tastatur (mit Tab-Taste, 
Pfeiltasten innerhalb von Gruppen usw.). Zusätzlich ruft sie 
bei den meisten Nachrichten, die sie erhält, die spezifizierte 
Dialogfunktion auf (Bild 4). In dieser kann der Program- 
mierer benötigte Nachrichten abfangen und selbst auswer- 
ten. Wird ein von Null verschiedener Wert zurückgegeben, 
dann hat die Dialogfunktion die Nachricht selbst bearbeitet, 
und die Fensterfunktion ignoriert die Nachricht. Wird dage- 
gen Null zurückgegeben, führt die Funktion ihre vorgese- 
hene Aufgabe durch. Es werden leider nicht alle Nachrich- 
ten an die Dialogfunktion übergeben. Die Schnittstelle ist 
teilweise etwas unsauber, man kann jedoch im großen und 
ganzen damit leben. Auf weitere Probleme mit Dialogfel- 
dern wird im zweiten Teil dieses Artikels eingegangen. 


Veränderung von angelegten Fenstern und 
Fensterklassen 


Oft müssen bereits angelegte Fenster oder sogar Fenster- 
klassen in ihrem Aussehen oder ihrer Funktion nachträglich 
geändert werden. Die Fenstergröße und -position kann 
leicht mit den Funktionen MoveWindow oder SetWindow- 
Pos verändert werden. Ähnlich verhält es sich mit dem 
Fenstertext, der mit der Funktion SetWindowText neu 
eingestellt werden kann. Dieser Text muß übrigens nicht 
unbedingt wie bei einem Anwendungsfenster in der Titellei- 
ste stehen, bei der Fensterklasse EDIT ist er zum Beispiel 
der einzeilig eingegebene Text. 

Doch wie steht es mit den anderen in Tabelle 1 oder 2 
angegebenen Parametern? Was tun, wenn man beispiels- 
weise die Hintergrundfarbe oder den Darstellungsstil eines 
bereits angelegten Fensters ändern möchte, ohne es vorher 
zu vernichten und wieder erneut anzulegen? Windows 
erlaubt das Ändern der Fenster- und Fensterklassenpara- 
meter von bereits angelegten Klassen und Fenstern. Hierzu 
stehen die Funktionen SetClassWord und SetClass- 
Long zum Ändern der Fensterklassen-Parameter und Set- 
WindowWord und SetWindowLong zum Ändern der Fen- 
sterparameter zur Verfügung. Bei diesen Funktionen wird 
zunächst das betreffende Fenster angegeben, dann der in 
Tabelle 1 und 2 angegebene Index und schließlich der neue 
Wert. Die bisher gesetzten Werte von Fenster- und Fenster- 
klassen-Parametern werden zurückgegeben oder lassen sich 
mit den entsprechenden Funktionen GetClassWord etc. 
ermitteln. Doch Vorsicht: Nicht alle Parametern dürfen 
geändert werden. 


Windows 


Die Veränderung bewirkt auch nur, daß der entspre- 
chende Parameter im Speicher den neuen Wert erhält. Die 
Fensterdarstellung wird nicht automatisch angepaßt! Ist 
beispielsweise ein Fenster in Sinnbildgröße dargestellt und 
ändert man nun den Bezug auf ein anderes Sinnbild, dann 
tut sich zunächst am Bildschirm nichts. Erst wenn das 
Fenster erneut in Sinnbild-Darstellung gezeichnet wird, 
wird das neue Sinnbild angezeigt. 


Unterklassen: 
Anpassung von vorhandenen Fensterklassen 


Manchmal muß jedoch nicht die Form eines Fenster geän- 
dert werden, sondern dessen Verhalten. Was heißt dies 
konkret? Nun, Fenster werden über Nachrichten gesteuert, 
die von der Fensterfunktion ausgewertet werden. Wenn sich 
das Verhalten eines Fensters ändern, ändert sich also das 
Verhalten seiner Fensterfunktion bei bestimmten Nach- 
richten. Dies kann nur durch Änderung der Fensterfunktion 
gelöst werden. Wenn man aber nicht über den Quellcode 
der Fensterfunktion verfügt, beispielsweise weil die Fen- 
sterklasse vom System vordefiniert oder in einer Bibliothek 
abgelegt ist, bleibt nichts anderes übrig, als die Funktion 
komplett gegen eine neue auszuwechseln. Dann muß diese 
alle Aufgaben der alten Fensterfunktion miterledigen, also 
auch solche, die von der Verhaltensänderung gar nicht 
betroffen sind. Bei komplizierten Fensterklassen wie EDIT 
führt dies zu einem sehr großen Programmieraufwand, so 
groß, als hätte man die Fensterklasse komplett selbst defi- 
niert. 

Viel einfacher ist dagegen folgender Weg: Die neue 
Fensterfunktion pickt sich die Nachrichten heraus, deren 
Reaktion geändert werden muß. Alle anderen Nachrichten 
werden dagegen wie bisher an die alte Fensterfunktion 
unverändert weitergeleitet. Die neue Funktion muß also nur 
einen kleinen Teil der Arbeit der alten Funktion erledigen. 
Durch diese Modifikation wurde die Klasse des angespro- 
chenen Fensters nur teilweise geändert, bei Microsoft wird 
sie nun als Unterklasse (subclass) bezeichnet. 

Programmtechnisch wird eine Unterklasse eines Fen- 
sters wie folgt realisiert: Nach dem Anlegen des Fensters 
wird seine bisherige Fensterfunktion mit SetWindowLong 
durch die neue ersetzt. Aus dieser wird dann mit Hilfe der 
Systemfunktion CallWindowProc die alte Fensterfunk- 
tion, die sogenannte Nachfolgerfunktion aufgerufen. Bild 5 
zeigt die Unterklassen-Technik im Schema. Es könnten 
auch mehrere Fensterfunktionen hintereinander angeordnet 
sein (Unter-Unter-Klassen). Wichtig ist das Grundprinzip, 
daß in einer Unterklassen-Fensterfunktion nur die Nach- 
richten geändert oder abgefangen werden dürfen, die tat- 
sächlich bei der Verhaltensänderung des Fensters eine 
Rolle spielen. Alle anderen Nachrichten (und das sind die 
meisten) müssen unverändert an die Nachfolgerfunktion 
weitergeleitet werden. 


Man muß sich Unterklassen-Fensterfunktionen so ähn- 
lich vorstellen wie Vorzimmerdamen von leitenden Ange- 
stellten: Alle eingehenden Nachrichten (Telefon, Briefe 
usw.) werden vom Vorzimmer überprüft, ob sie den Chef 
interessieren, falls nicht, weggeworfen oder anderwertig 
bearbeitet. Unbekannte Nachrichten werden dagegen 
unverändert weitergeleitet. Manchmal muß die Dame für 
ihre Aufgaben zusätzlich Rücksprache mit dem Chef auf- 
nehmen. Hierzu schickt sie selbst Nachrichten (Telefon, 
persönliches Gespräch) an ihn und er antwortet ihr direkt, 
ohne daß diese Kommunikation über das Vorzimmer hin- 
ausdringt. 

Die Technik der Unterklassen zeigt, wie elegant die 
Kombination Nachricht-Fenster-Fensterfunktion ist. Würde 
ein Fenster durch viele verschiedene Funktionsaufrufe 
anstatt durch Nachrichten gesteuert werden, wäre die 
Unterklassentechnik nicht anwendbar. 

Unterklassen eignen sich vor allem zur Verhaltensände- 
rung vordefinierter Fensterklassen. In /4] wird auf Seite 410 
bis 419 beispielsweise gezeigt, wie man die EDIT-Klasse 
dazu verwenden kann, Paßwörter oder andere geheime 
Information einzugeben. Die eingegebenen Zeichen sind im 
Eingabefeld nicht sichtbar, weil jedes eingegebene Zeichen 
in einem gesonderten Puffer gespeichert wird, und statt des 
Zeichens die Rücktaste an die eigentliche EDIT-Fenster- 
funktion geschickt wird, somit also das angezeigte Einga- 
befeld immer leer bleibt. Durch ähnliches Abfangen von 
bestimmten Zeichen kann man zum Beispiel auch errei- 
chen, daß in einem Feld nur Buchstaben oder nur Zahlen 
oder nur gültige Geldwerte eingegeben werden können - 
wichtig beim Programmieren von Anwendungssoftware. 

Im folgenden wird ebenfalls ein Beispiel für eine EDIT- 
Unterklasse vorgestellt, es ist jedoch etwas komplizierter als 
das eben zitierte. Es zeigt jedoch auch die Kommunikation 
der Unterklassenfunktion mit ihrer Nachfolgerin über 
lokale Nachrichtenströme. 


Beispiel: Verbesserung der Fensterklasse EDIT 


Wer schon einmal mit Microsofts EXCEL gearbeitet hat, 
hat sicherlich bemerkt, daß man bei ihm in jedem Fenster 
(auch innerhalb von Dialogfeldern) vom standardmäßigen 
Einfügen von Zeichen auf »Überschreiben« derselben 
durch Betätigen der (Einfg)-Taste hin- und herschalten 
kann. Das Überschreiben wird durch Anzeigen einer breite- 
ren Einfügemarke kenntlich gemacht. Dies wurde einfach 
dadurch realisiert, daß das Zeichen, das überschrieben wird, 
ständig markiert ist (so als würde man ständig 
eingeben). Als weitere Erweiterung kann man mit 
die markierten Zeichen in die Ablage kopieren. 
Diese beiden Möglichkeiten sind sehr praktisch, so daß 
eigentlich die Fensterklasse EDIT sie standardmäßig besit- 
zen sollte. Leider wurden sie bei der Implementierung von 
EDIT in Windows weggelassen. Es bietet sich nun an, das 
Fehlen dieser beiden Fähigkeiten mit Hilfe einer Unter- 
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klasse von EDIT zu implementieren. Bei Excel wurde dies 
übrigens nicht so gemacht, sondern eine vollständig neue 
Fensterklasse namens XLFEDT erzeugt. Die Entwickler 
von Excel hatten es auch einfach, schließlich war der Quell- 
code von EDIT nur ein paar Türen weiter erhältlich! 

Bei der eigentlichen Implementierung wurde mir 
schließlich klar, daß tatsächlich eine neue Fensterklasse 
sinnvoller ist als von EDIT eine Unterklasse zu erzeugen. 
Die Fensterklasse EDIT ist nämlich ziemlich schlampig 
implementiert und der Programmierer dachte wohl nicht 
daran, was einige Leute mit seiner Fensterfunktion vor- 
haben. Trotzdem, uns geht es ja ums Prinzip und das 
Ergebnis kann sich sehen lassen, denn beide Erweiterungen 
wurden prinzipiell implementiert. 

Listing 1 zeigt das C-Listing des Programms SUB- 
CLASS, die gehörige Ressourcen-Datei steht in Listing 3, 
die unvermeidbare Definitionsdatei in Listing 4. Zum Über- 
setzen wurde der Microsoft-C-Compiler, Version 5.1 ver- 
wendet. Es wird mindestens Version 5.0 des Compilers 
benötigt, da das Programm einige Features des neuen 
ANSI-C [7] besitzt. Das betrifft in erster Linie die neuartige 
Anordnung der Typen in den Funktionsargumenten, die 
etwas an Pascal erinnert. Die Linker-Anweisungsdatei ist in 
Listing 5 aufgeführt. Auch hierzu ein Wort: Die Zeilen 
REALMODE und EXETYPE WINDOWS sind neu. Sie 
werden benötigt, wenn man mit dem OS/2-Linker 
LINK.EXE 5.01.21 (liegt MS-C 5.1 bei) Windows-Pro- 
gramme übersetzen will. Werden die Zeilen weggelassen, 
wird das Programm für den »protected modus« übersetzt 
und es geschehen beim Aufruf merkwürdige Dinge. Die 
beiden neuen Zeilen werden jedoch auch vom Vorgänger, 
dem Linker des Windows-SDK, LINK4.EXE 5.01.17 pro- 
blemlos verarbeitet. Statt MOVEABLE kann jetzt der 
gebräuchlichere englische Begriff MOVABLE verwendet 
werden. Englisch ist halt auch für Amerikaner nicht ganz 
einfach. Alles wird übersetzt mit der MAKE-Datei in 
Listing 2. 

Die Beschreibung der Anwendung kann ziemlich kurz 
ausfallen: Es werden zwei Fenster von der EDIT-Klasse an- 
gelegt: Das erstere belegt den gesamten Inhalt des Anwen- 
dungsfensters und erlaubt die Eingabe von mehreren Zeilen 
bis maximal 32 Kbyte. Genauso wurde übrigens auch das 
Programm NOTIZ.EXE implementiert, ergänzt um Datei- 
ein-/ ausgabe, Suchfunktion etc. Es handelt es sich hierbei 
um ein explizit mit CreateWindow angelegtes Tochterfen- 
ster des Anwendungsfensters. Man kann mehrere Zeilen 
eintippen, einen Bereich markieren, Text mit (Unsch)[Einfg) 
aus der Ablage kopieren oder mit bzw. 
den markierten Text löschen. Dies sind jedoch standard- 
mäßige Merkmale der EDIT-Klasse, die beispielsweise 
auch bei der Eingabe eines Dateinamens in PAINT vorhan- 
den sind. Neu ist, daß mit der markierte Text in 
die Zwischenablage kopiert wird, ohne daß er gelöscht wird. 
Neu auch der Überschreiben-Modus: Durch Betätigen der 
(Einfg)-Taste wird aus der Einfügemarke, sofern sie nicht 
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am Zeilenende steht, wie bei EXCEL eine breite Einfüge- 
marke, indem das aktuelle Zeichen markiert wird. Wird ein 
neues Zeichen eingegeben, überschreibt dies automatisch 
das markierte Zeichen. Anschließend wird das neue aktu- 
elle Zeichen wieder markiert. Man kann weiterhin Text 
explizit markieren, einfügen, löschen etc., es wird jedoch 
ständig mindestens ein Zeichen markiert sein, außer die 
Einfügemarke ist am Zeilenende. Damit ist der Überschrei- 
ben-Modus realisiert. Er wird mit der (Einfg)-Taste ein- und 
ausgeschaltet. 

Eine zweite Möglichkeit zum Testen ist ein Fenster der 
EDIT-Klasse innerhalb eines Dialogfelds. Dieses wird 
durch den Menübefehl »Zeile« aufgerufen. Es handelt sich 
hierbei um die Einzeilen-Version der EDIT-Klasse. Auch 
hier funktioniert die Kopierfunktion mit [Strg)(Einfg). 
Wegen eines Fehlers in der EDIT-Klasse ist jedoch der 
Überschreibmodus leider nicht möglich (siehe nächstes 
Kapitel). 

Das Beispiel soll eigentlich nur zeigen, wie man Unter- 
klassen realisiert und daß man sie sowohl bei mit Create- 
Window angelegten Fenstern verwenden kann als auch 
innerhalb von Dialogfeldern. 

Das C-Listing besitzt den schematischen Aufbau der 
meisten Windows-Programme, so daß hier nur die für die 
Unterklassentechnik relevanten Stellen beschrieben werden. 
Die Unterklassenfunktion wird genauso definiert wie jede 
andere Fensterfunktion. Im Beispiel besitzt sie den Namen 
fwSubEdit. Sie darf jedoch nicht direkt aufgerufen wer- 
den, sondern nur über den mit der bekannten Funktion 
MakeProcInstance erzeugten Funktionskopf. Dies wird 
in der Programm-Funktion SetGlobalProcedure durch- 
geführt, in der die Erzeugung der Funktionsköpfe zusam- 
mengefaßt ist. In CreateAppWindow wird dann zuerst das 
Anwendungsfenster und anschließend das Tochterfenster 
(WS_CHILD) mit der EDIT-Klasse angelegt. IDEDIT ist die 
Bezeichnung des Tochterfensters und mit hwMain ist der 
Bezug auf das Vaterfenster angegeben. 

Am Ende von CreateAppWindow erfolgt die Einfüh- 
rung der Unterklasse, indem die Original-Fensterfunktion 
des EDIT-Fensters mit Hilfe der Funktion SetWindow- 
Long durch die Unterklassen-Funktion ausgetauscht wird. 
Die Adresse der alten Funktion benötigen wir natürlich 
weiterhin und sie wird in der Variablen rfwOrgEdit 
gespeichert. Ab sofort werden die Nachrichten zur Funktion 
rfwSubEdit gesandt. Die Unterklasse bleibt erhalten, bis 
das EDIT-Fenster vernichtet wird. Dies wird erst beim 
Beenden der Anwendung stattfinden. 

Ähnlich verhält es sich beim Einsatz der Unterklassen- 
technik in einem Dialogfeld, hierfür ist die Dialogfunktion 
fdLine zuständig. Ein Fenster kann natürlich nur dann 
eine Unterklasse erhalten, wenn es bereits angelegt ist. 
Letzteres geschieht aber hier erst durch den Aufruf der 
Funktion DialogBox, wenn das Dialogfeld dargestellt 
werden soll. Dies ist jedoch kein Problem: Nachdem Dia- 
logBox das Hauptfenster und die Tochterfenster des Dia- 


logfelds angelegt (aber noch nicht angezeigt) hat, übersen- 
det es an die Dialogfunktion fdLine die Nachricht 
WM_INITDIALOG. Dort kann dann wie bereits oben 
beschrieben, die Fensterfunktion ausgetauscht werden. Das 
war schon alles. 

Wie man sieht, ist die Anwendung der Unterklassen- 
Technik sehr einfach. Man muß lediglich die Fensterfunk- 
tion eines angelegten Fensters durch die vorangestellte 
austauschen. Die eigentliche kreative Arbeit steht in der 
Unterklassen-Fensterfunktion bevor. 


Die Unterklassen-Fensterfunktion 


Die erste Nachricht, die es abzufangen gilt, ist 
WM_SETFOCUS. Da es nicht günstig ist, beim Aufruf eines 
Eingabefeldes sich gleich im Überschreiben-Modus zu 
befinden (zu leicht könnten Zeichen überschrieben wer- 
den), wird der Modus jedesmal abgeschaltet, wenn der 
Benutzer das Eingabefeld anwählt. 

Die wichtigste Nachricht ist jedoch WM_KEYDOWN. Sie 
erscheint jedesmal, wenn eine Taste auf der Tastatur 
gedrückt wird oder beim Festhalten die automatische 
Tastenwiederholung einsetzt. Hierbei wird nicht der ANSI- 
Zeichencode übergeben, sondern der Wert der virtuellen 
Taste. Virtuelle Tasten umfassen auch alle Steuertasten wie 
(Einfg), (Alt), usw. Von diesen Tasten muß nur die 
(Einfg)-Taste (virtuellen Tastencode VK_INSERT) unter- 
sucht werden. Wurde sie zusammen mit der (Strg)-Taste 
gedrückt, so hat der Benutzer die Kopierfunktion aufgeru- 
fen. Deren Implementierung ist sehr einfach: Es muß ein- 
fach die Nachricht WM_COPY an die ursprüngliche Fenster- 
funktion geschickt werden. Dies funktioniert durch die 
Verwendung der Funktion CallWindowProc. Als Argu- 
ment ist die Adresse der gesicherten alten Fensterfunktion 
angegeben. 

Wurde die (Einfg)-Taste allein gedrückt, wird hiermit 
der Überschreiben-Modus ein- und ausgeschaltet. Der 
Überschreiben-Modus funktioniert nur bei einer EDIT- 
Klasse mit mehreren Zeilen (der Grund folgt unten). In der 
Unterklassen-Funktion wird daher zunächst der Fensterstil 
mit der Funktion GetWindowLong darauf überprüft. 

Mit dem Betätigen der (Einfg)-Taste kann der Modus 
ein- oder ausgeschaltet werden. Bei letzterem muß auch die 
breitere Einfügemarke beseitigt werden. Dies darf natürlich 
nur geschehen, wenn die Markierung auch tatsächlich die 
Einfügemarke darstellt und genau ein Zeichen breit ist. In 
diesem Falle wird die Markierung auf null Zeichen ver- 
kürzt. 

Alle anderen Nachrichten (WM_KEYDOWN mit anderen 
Tasten, WM_PAINT, WM_SIZE usw.) werden unverändert an 
die ursprüngliche Fensterfunktion weitergeleitet. Dies 
geschieht mit einem gemeinsamen CallWindowProc-Auf- 
ruf. Dessen Rückgabewert wird auch als Rückgabewert der 
Unterklassen-Funktion verwendet. 
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Sind alle Nachrichten bearbeitet, muß sichergestellt 
werden, daß während des Überschreiben-Modus das aktu- 
elle Zeichen markiert bleibt. Denn bei jeder Zeichenein- 
gabe, Maustasten-Betätigung usw. kann die Markierung 
gelöscht worden sein und muß daher erneut als breites Ein- 
gabezeichen gesetzt werden. Hierzu muß zunächst die Ein- 
fügeposition bestimmt werden. Das ist aber bei der EDIT- 
Klasse gar nicht möglich. Man kann nur den Bereich der 
markierten Zeichen erhalten. Da jedoch die Einfügemarke 
sich immer in diesem Bereich befindet, kann die Markie- 
rung zur Positionsbestimmung verwendet werden. Hierzu 
schickt die Unterklassen-Funktion eine EM_GETSEL-Nach- 
richt an ihre Nachfolgerfunktion und diese liefert die 
Anfang- und Endposition der Markierung zurück. Sind 
beide Positionen gleich; ist kein Zeichen markiert, und es 
muß mit der EM_SETSEL-Nachricht das folgende Zeichen 
markiert werden. Sind dagegen mehrere Zeichen markiert, 
darf keine neue Selektion durchgeführt werden, denn in 
diesem Fall ist die Markierung vom Benutzer explizit über 
mehrere Zeichen ausgedehnt worden (beispielsweise zum 
Löschen von Zeichen). 

Und nun zum oben angesprochenen Problem: Soll der 
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Überschreiben-Modus richtig funktionieren, muß die blin- 
kende Einfügemarke (Caret) links vom markierten Zeichen 
stehen. Bei dem Mehrzeilen-EDIT-Fenster funktioniert 
dies korrekt. Bei dem Einzeilen-EDIT-Fenster (verwendet 
im Dialogfeld) wird dagegen mit EM_SETSEL die Einfüge- 
marke merkwürdigerweise hinter den markierten Bereich 
gestellt und dies läßt sich nicht korrigieren. Mit dem vorge- 
stellten Prinzip läßt sich daher der Überschreiben-Modus 
beim Einzeilen-EDIT nicht realisieren. Die Realisierung ist 
deutlich komplizierter und würde den Rahmen des Artikels 
sprengen. Es wurde deshalb darauf verzichtet. 

Michael Geary hat in /5] eine weitere interessante 
Anwendung von Unterklassen angesprochen: Die dynami- 
sche Änderung von Fenstereigenschaften während des Ab- 
lauf von Programmen. In seinem Beispiel verhalten sich in 
einem von ihm entwickelten Layout-Editor beispielsweise 
Schaltflächen (PushButton) bei der interaktiven Erzeugung 
eines Dialogfelds anders als bei deren späteren Benutzung, 
indem während der Erzeugungsphase die BUTTON-Klasse 
so abgeändert wird, daß beim Anklicken der Schaltfläche 
diese nicht aktiviert wird, wie man gewohnt ist, sondern 
markiert wird, um verschoben werden zu können. 
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Eine weitere sinnvolle Anwendung ergibt sich bei Lern- 
programmen für eine Windows-Anwendung. Lernprogram- 
me erlauben an einer Eingabestelle des zu erlernenden Pro- 
gramms oft nur eine kleine Auswahl an Eingabemöglich- 
keiten, damit der Auszubildende nicht durch fehlerhafte 
Eingaben versehentlich aus dem roten Faden des Lernpro- 
gramms aussteigen kann. Ein Lernprogramm sollte nicht 
ein Teil des zu erlernenden Programms sein, denn das 
würde die Komplexität für den Normalbetrieb unnötig 
erhöhen. Es muß deshalb von außen die Eingabemöglich- 
keiten kontrollieren können, etwa dadurch, daß es alle 
Nachrichten an das zu erlernende Programm abfängt und 
nur die gültigen weiterreicht, indem ein Systemeingriff 
(System Hook) /6] eingebaut wird. Das ist jedoch sehr auf- 
wendig und fehlerträchtig, da das gesamte Verhalten einer 
Anwendung berücksichtigt werden muß. Eleganter ist es, 
der Fensterfunktion, die den Eingabefokus besitzt, im 
Lernmodus eine Unterklassen-Fensterfunktion voranzustel- 
len, welche nur die gültigen Eingabenachrichten weiter- 
leitet, die anderen dagegen blockiert. 

Wie man sieht, kann man mit Unterklassen schöne 
Dinge schnell und einfach lösen (wenn wir einmal davon 
absehen, daß für das Beispiel die EDIT-Klasse nicht sauber 


genug implementiert wurde). Doch was macht man, wenn 
man ein komplett anderes Fenster braucht, zum Beispiel 
eine Laufwerk-Liste wie im MS-DOS-Fenster? Dann muß 
man eben seine eigenen Fensterklassen definieren. Das ist 
natürlich komplizierter als das »Aufblasen« einer vorhan- 
denen Fensterklasse. Wie man Fensterklassen selbst er- 
zeugt, können Sie in der Fortsetzung dieses Artikels im 
nächsten Heft erfahren, wenn zwei für Windows sehr unge- 
wöhnliche Dialogelemente in einer ungewöhnlichen Anwen- 
dung vorgestellt werden. Marcellus Buchheit 
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wie für den Fortgeschrittenen. 
1988, 412 Seiten, 
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Quick C Toolbox 
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Quick C, Version 1.01 und Micro- 
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stieg und einen Überblick über 
das neue Betriebssystem MS- 
OSI2! 
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den Themenkomplexe behan- 
delt wie Speicherverwaltung, 
Multitasking und Programmier- 
schnittstelle. Im zweiten Teil fin- 
den Sie praktische Program- 
mierbeispiele, und der dritte Teil 
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Referenzteil. 
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BASIC 


Ein Interview mit Ray Kanemori über die Z 


Das neue QuickBASIC 


Auf der diesjährigen CeBIT wird das neue 
QuickBASIC 4.5 in einer deutschen Version vor- 
gestellt. QuickBASIC 4.5 hat zwar nur wenige 
Spracherweiterungen, bietet dafür aber ausge- 
feilte Lernhilfen und umfangreiche Hilfeinfor- 
mationen. QuickBASIC bietet damit für den 
Einsteiger den gleichen Komfort, wie dies die 
Anwendungen von Microsoft schon lange tun. 
Wir haben uns mit Ray Kanemori, dem Product 
Marketing Manager für BASIC von Microsoft 
USA, über QuickBASIC 4.5 und die Zukunft von 
BASIC bei Microsoft unterhalten. 


MSJ: In welche Richtungen wird sich Microsoft-BASIC und 
im besonderen QuickBASIC in den nächsten zwei Jahren 
entwickeln? 


Kanemori: Wir werden mehr und mehr professionelle 
Sprachfeatures in BASIC haben. Eine der Richtungen, in 
die wir BASIC weiterentwickeln, sieht so aus, daß wir 
BASIC zu einer wirklichen Profi-Sprache machen wollen. 
Wir arbeiten zum Beispiel an verbesserter Leistung bei den 
vom Compiler erzeugten EXE-Dateien. In diesem Zusam- 
menhang arbeiten wir auch an einer erweiterten Kapazität, 
so daß Sie auch in BASIC wirklich große Anwendungen 
schreiben können. Auch bei Overlays wird sich etwas tun. 
Weniger im QuickBASIC, das wir mehr als Einsteigerspra- 
che sehen, jedoch in unserem High-End-BASIC. Quick- 
BASIC ist eine Sprache, die mehr auf lösungsorientierte 
Programmierer ausgerichtet ist, mit dem Ziel, daß sie sehr 
schnell produktiv werden können. 

QuickBASIC ist eine sehr leistungsfähige Sprache und 
es gibt viele professionelle Entwickler, die QuickBASIC als 
ihr hauptsächliches Entwicklungswerkzeug verwenden. Man 
kann mit QuickBASIC sehr leistungsfähige Anwendungen 
schreiben, es gibt jedoch auch einige Einschränkungen, zum 
Beispiel in der Größe der Anwendungen, die man schreiben 
kann. Wir werden diese Einschränkungen entfernen. 

Wir haben in letzter Zeit bemerkt, daß bei BASIC ein 
Trend zum High-End besteht. Die Benutzer haben gefor- 
dert, daß QuickBASIC eine größere Kapazität hat, so daß 
man größere Anwendungen entwickeln kann. Viele Leute 
meinen, daß die ausführbaren Dateien zu groß sind. Wir 
werden bei der Größe und auch der Geschwindigkeit der 
erzeugten Programme einige Optimierungen vornehmen. 
Es spricht nichts dagegen, daß BASIC in Punkto Geschwin- 
digkeit langsamer sein sollte als C oder Pascal. 


MSJ: Heißt das, daß Sie den Optimierer aus C und Fortran in 
BASIC einbauen werden? 

In BASIC werden auch schon derzeit Optimierungen vor- 
genommen und es ist eigentlich schon recht schnell. Es wird 
aber sicherlich einiges von dieser Technologie übernommen 
werden. 
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nft von BASI 


i Microsoft: 


Bild 1: Ray Kanemori 


MSJ: BASIC wird also stärker auf den Profi ausgerichtet? 
Kanemori: Nicht QuickBASIC 4.5. In der Version 4.5 haben 
wir uns darauf konzentriert, viele Lernhilfen einzubauen 
und Programmierern dabei zu helfen, schnell produktiv zu 
werden. QuickBASIC 4.0 war ein großer technologischer 
Fortschritt. Mit seiner Threaded-P-Code-Technologie kann 
man Anwendungen sehr schnell entwickeln. Wir haben in 
4.0 auch viele Neuheiten wie Records und Rekursion einge- 
führt, die QuickBASIC sehr leistungfähig gemacht haben. 

Die Sprache wurde in der Version 4.5 nur bei drei oder 
vier Anweisungen erweitert, und zwar wurde der Bereich 
der Ereignisabfrage (ON EVENT und benutzererdefinierte 
Ereignisse) um die Möglichkeiten von BASIC 6.0 erweitert. 
Es ist so, daß wir QuickBASIC auch weiter als das Produkt 
zum Erlernen des Programmierens sehen: ein Weg, die 
Sprache BASIC sehr schnell zu meistern und schr schnell 
produktiv zu werden. BASIC 6.0 und seine Nachfolgepro- 
dukte sehen wir als Sprachen für das obere Marktsegment 
der professionellen Programmierer. Viele professionelle 
Programmierer verwenden BASIC, wir werden deshalb in 
den Folgeprodukten von BASIC 6.0 mehr professionelle 
Möglichkeiten bieten, die BASIC für Profis attraktiver 
machen. 


BASIC 


Suchen us fuhren Ort 
’ rzkombı na 


Einfügen Kopieren 
Einfügen/Oberschreiben EINFG | Harkierten Text STRG+EINFG | 
Zeile darüber POS1_STRG+M 
ee I 
om Auss: - 

ich Sr HALT+EINFG Wein ee S N 


Markieren 
Zeichen/Zeilen _UMSCHALT+PFEIL 
Wörter UMSCHAL+STRG+PFEIL 


Löschen 
Aktuelle Linie 
s Lini 
Drü beliebige Taste um fortzufahren. ? 


Fr WHILE INKEY$ = "" 
le Gerade über den 


* Lösche Bildschirm 
0, 0)-(319, 199 "Zeichnet eine diago 


Bild 2: Die wichtigste Neuheit von QuickBASIC 4.5 ist der 
Ratgeber, der das komplette QuickBASIC-Handbuch mit 
vielen Beispielen enthält. Es können nicht nur Informationen 
zur Bedienung... 


MSJ: Können Sie etwas detaillierter auf einzelne Features 
oder Befehle eingehen? 
Kanemori: Dazu wäre es noch zu früh, doch wie ich schon 
gesagt habe, wird es dabei im wesentlichen um die Steige- 
rung der Produktivität und die Größe der Anwendungen 
gehen. Es werden sehr viele geschäftliche Anwendungen 
mit BASIC entwickelt, die Erweiterungen haben darum 
dieses Einsatzgebiet zum Ziel, daß man also geschäftliche 
Anwendungen mit BASIC noch besser schreiben kann, zum 
Beispiel neue mathematische Bibliotheken oder Matrix- 
Anweisungen. 

Ferner ist für das High-End-Produkt die Programmer’s 


Workbench geplant, eine integrierte Programmierumge-. 


bung ähnlich wie die Quick-Umgebung, aber mit der Mög- 
lichkeit, daß man seine eigenen Tools in diese Umgebung 
integrieren kann, zum Beispiel CodeView. Man kann also 
bei der Entwicklung in der gewohnten Umgebung bleiben 
und dennoch auch andere Tools einsetzen. 


MSJ: Wie sieht es mit den noch bestehenden Einschränkun- 
gen von BASIC aus? Ich selbst haben zum Beispiel bei der 
Programmierung mit QuickBASIC häufig Probleme mit der 
Beschränkung des Stringspeichers auf 64 Kbyte. 

Kanemori: Wir werden bei unserem High-End-Produkt in 
dieser Richtung sicher etwas unternehmen, man wird 
irgendwann den ganzen freien Speicher für Strings verwen- 
den können. 


MSJ: Die Handbücher zu QuickBASIC 4.5 sind nicht mehr so 
umfangreich, wie bei früheren Versionen. Warum? 

Kanemori: Wir haben festgestellt, daß die meisten Benutzer 
nicht ins Handbuch schauen, sondern Informationen aus 
den Hilfebildschirmen abrufen und gerne dort mehr Infor- 
mationen sehen würden. Wir glauben deshalb, daß der 
Trend zu mehr Online-Informationen geht. Unser Quick- 
BASIC-Ratgeber ist ein ausgezeichnetes Beispiel für diese 
Technologie (Bilder 2 bis 5). 


«Grenzen von QuickB i 
Grenzen von QuickBASIC - Datenfelder 
Max: 
Anzahl der erlaubten Dimensionen 1 
Datenfeld-Index-Wert 32.767 -32.768 
Hinweis: Der ame Bereich zwischen Datenfeld-Index-Werten beträgt 
U 
SCREEN 1 
LINE -(x2, Y2) 
00 


Datenfeldgröße (alle Elemente) 
Static 
€ 


LINE. BAS 
"Stellt den Bildschirm ein. 


*"Zeichnet eine Gerade (in der Vordergrundfar 
'vom letzten Punkt zu un 


Direkt 


Bild 3: ... sondern auch alle anderen Informationen, die 
gewöhnlich in einem Handbuch stehen, abgerufen werden. 
Zahlreiche Verweise erleichtem das Auffinden verwandter 
Themen. 


Man kann Beispielprogramme aus dem Ratgeber heraus 
in ein eigenes Programm hinein kopieren und ausführen. 
Wenn man zu einer Anweisung detailliertere Informationen 
möchte, braucht man nur auf dem Bildschirm das Wort 
»Detail« anklicken und erhält diese Informationen. Ich 
glaube, daß dies für den Anwender nützlicher ist, als Hand- 
bücher. Es gibt alle Referenzinformationen und Beispiele 
direkt im Produkt und ich denke, daß man dies beim Pro- 
grammieren lieber alles Online als in einem Handbuch hat. 
Natürlich gibt es auch noch die normalen Handbücher 
inklusive Referenzinformationen, doch ist alles knapper 
gehalten und auch die Beispiele sind in den Online-Rat- 
geber verlagert worden. So kann der Anwender alle diese 
Beispiele durch Kopieren auch direkt bei der Programmie- 
rung nutzen, ohne sie umständlich selbst eingeben zu 
müssen. 

Wer die bisherige Form vorzieht, kann diese Hand- 
bücher auch weiterhin optional von Microsoft erhalten. 
Doch wir haben die Erfahrung gemacht, daß den meisten 
Benutzern eine kurze Referenz auf Papier reicht. 


MSJ: Was hat sich sonst noch bei QuickBASIC 4.5 getan? 
Kanemori: Wir haben zahlreiche Untersuchungen mit 
Anwendern durchgeführt, weil wir wissen wollten, wie sie 
vorgehen, um mit QuickBASIC möglichst schnell möglichst 
produktiv zu werden. Dabei zeigte sich, daß die Menü- 
punkte von QuickBASIC 4.0 von Anwendern als zu umfang- 
reich angesehen wurden. Wir haben das dann genauer 
untersucht und versucht herauszufinden, was für den leich- 
ten Einstieg die optimale Anzahl an Menüpunkten ist. Dar- 
aus entstand die Kurzform der Menüs in QuickBASIC 4.5, 
bei denen es sich um eine Untermenge der vollständigen 
Menüs handelt, und zwar um die unbedingt notwendigen 
und die am häufigsten benötigten. Dadurch kann der 
Anwender die Lernphase um einiges verkürzen. Das ist also 
ähnlich wie bei Microsoft Excel. 
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BASIC 


zei chenkette 
stellen. 


ea Ungebengszei chenkette) 


noszeichenkette eine Zeichenketten-Konstante oder -Variable, 


L} 
ist der Bo r Umgebungszeichenkette, dessen aktueller Wert zurück- 
wi 


sdruck, der anzeigt, Rn die n-te u Zei ChanIette 
gszeichenketten-Tabelle zurückzug ist ’ 


.nıst ein nuneriscl 


„BAS ’ 
‘Drücke beliebige Taste um fortzufahren. 


"Zeichnet eine disgonale Gerade über den 
"Bildschirm (abwärts). 


Direkt 


Bild 4: QuickBASIC erlaubt im Hilfefenster viele Befehle aus 
dem Editor. So kann man im Hilfetext zum Beispiel wie im 
Programm nach Wörtern und Begriffen suchen. 


Auch das neue Installationsprogramm von QuickBASIC 
zielt darauf ab, dem Anwender den Start zu erleichtern und 
ihn möglichst schnell zum Arbeiten kommen zu lassen. 
Ebenso das Lernprogramm für QuickBASIC, mit dem man 
sich in 10 Minuten mit dem Umgang mit QuickBASIC 4.5 
vertraut machen und die Umgebung kennenlernen kann. 
Doch am wichtigsten war uns der QuickBASIC-Ratgeber. 
Wir haben sehr viel Arbeit in diese Technologie gesteckt 
und versucht, wesentlich mehr Informationen als bisher in 
die Programmierumgebung hineinzubekommen. 

Aber auch im Handbuch hat sich etwas getan. So befin- 
det sich darin jetzt ein Einführungskurs mit einem umfang- 
reichen Beispiel für eine Dateiverwaltung, dessen Entwick- 
lung dem Benutzer Schritt für Schritt verdeutlicht wird. 

Auch beim Programmieren wird der Benutzer nun bes- 
ser informiert. So wurden die Fehlermeldungen stark ver- 
bessert und enthalten jetzt genaue Fehlerbeschreibungen 
und Tips für die Korrektur. Zu den kleinen, aber ungemein 
nützlichen Erweiterungen gehört, daß man sich nun jeder- 
zeit den aktuellen Wert einer Variablen anzeigen lassen 
kann, indem man auf diese Variable zeigt und eine Funk- 
tionstaste drückt. 


MSJ: Wird es in Zukunft auch BASIC-Versionen für andere 
Umgebungen geben, zum Beispiel für Windows oder den Pre- 
sentation Manager? 

Kanemori: Wir sind derzeit dabei, uns andere Umgebungen 
unter diesem Gesichtspunkt anzusehen. Genaueres kann ich 
dazu momentan noch nicht sagen, doch schen Sie sich ein- 
mal den neuen QuickBASIC-Compiler für den Macintosh 
an. Hier wird die grafische Umgebung voll unterstützt und 
es werden auch Möglichkeiten für den Zugriff auf die Tool- 
box-Funktionen geboten. Dieser Compiler ist ein gutes Bei- 
spiel dafür, wie Microsoft BASIC in einer grafischen Fen- 
sterumgebung aussieht und arbeitet. Er zeigt, daß man mit 
BASIC auch in diesen Umgebungen einfacher programmie- 
ren kann, als mit Programmiersprachen wie C. 
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EMVIRON$-Funktion Prograsmierbeispiel 


Das folgende Beispiel benutzt die Funktion ENVIRON$ um die aktuellen 
Einstellungen der Umgebungszeichenketten-Tabelle auszugeben: 


a ’ 
men Pape *'Drücke beliebige Taste um fortzufahren. 


ar MHILE 
che Bildschirm 


Eine (0, . (319, 199) "Zeichnet eine en Gerade über den 


"Bildschirm (abwä 


0 
LOOP WHILE INKEY$ = "" ren beliebige Taste um fortzufahren. 
re 


Bild 5: Wenn man ein für das eigene Programm nützliches 
Programmbeispiel oder Modul findet, kann man es markieren 
und in das eigene Programm hineinkopieren. 


MSIJ: Wie sehen Ihre Pläne für GW-BASIC aus? 

Kanemori: Wir werden GW-BASIC weiter mit MS-DOS 
ausliefern und auch weiter pflegen, weitere Pläne bestehen 
derzeit nicht. 


MSJ: In der Presse war in den letzten Wochen gelegentlich 
etwas von einem Embedded BASIC zu hören. Worum han- 
delt es sich dabei und was hat es mit BASIC zu tun? 
Kanemori: Embedded-BASIC ist ein langfristige Entwick- 
lungsrichtung für die Integration unserer Anwendungspro- 
gramme. Die Sprache wird QuickBASIC sehr ähnlich sein; 
viele Dinge der QuickBASIC-Technologie werden über- 
nommen werden. 


MSJ: Herr Kanemori, vielen Dank für dieses Gespräch. 


Eigenschaft 20 30 40 45 
On-Line OB-Ratgeber Nein Nein Nein Ja 
Funktion der rechten Maustaste wählbar Nein Nein Nein Ja 
Stoppbedingungen Variablen/Ausdrücke Nein Nein Nein Ja 
Setzen von Standard-Suchpfaden Nein Nein Nein Ja 
Benutzerdefinierte Typen Nein Nein Ja Ja 
IEEE-Format, math. Koprozessor Nein Ja Ja Ja 
On-Line-Hilfe Nein Nein Ja Ja 
Lange (32-bit) Ganzzahlen Nein Nein Ja Ja 
Zeichenketten fester Länge Nein Nein Ja Ja 
Syntaxprüfung bei der Eingabe Nein Nein Ja Ja 
Binär-Datei-E/A Nein Nein Ja Ja 
FUNCTION-Prozeduren Nein Nein Ja Ja 
CodeView-Unterstützung Nein Nein Ja Ja 
Kompatibilität zu anderen Sprachen Nein Nein Ja Ja 
Mehrere Module im Speicher Nein Nein Ja Ja 


Nein Ja Ja Ja 


Kompatibel zu residenten Programmen 
Nein Ja Ja Ja 


Einfüge-/Überschreib-Modus 
Tastaturschnittstelle im WordStar-Stil Nein Ja Ja 
Rekursion Nein Nein Ja Ja 
Fehler-Listings bei separater Kompilierung Nein Ja Ja Ja 
Assembler-Listings bei sep. Kompilierung Nein Ja Ja Ja 


Tabelle 1: Eine Gegenüberstellung der Fähigkeiten der Quick- 
BASIC-Versionen von 2.0 bis 4.5 zeigt, welche Fortschritte die 
Sprache bei Microsoft in den letzten Jahren gemacht hat. 


Termine 


Termine 


Mit Microsoft-Seminaren sicher in die Zukunft 


Die Spezialseminare des Microsoft Instituts vermitteln in 
kleinen Gruppen intensiv all das, was zum Einstieg in die 
Programmentwicklung unter OS/2 und Windows nötig ist. 
Modernste Trainingsmethoden sowie PC-Demonstrationen 
und -Übungen sind selbstverständlich. Die Dozenten 
befassen sich auch im persönlichen Gespräch ausführlich 
mit den individuellen Forderungen und Problemen der 
Teilnehmer. So bekommen professionelle Entwickler durch 
professionelle Schulung die Möglichkeit, ihren hohen 
Wissensstand den neuen Gegebenheiten anzupassen. 

Jeder Interessent in der Bundesrepublik Deutschland, 
der Schweiz und Österreich hat so die Chance, sich mit der 
neuen Welt von Microsoft OS/2 und Microsoft Windows 
auseinanderzusetzen. 


Das Microsoft OS/2 Einführungsseminar 


Das zweitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmierkenntnisse in einer höheren Pro- 
grammiersprache wie C, Pascal, o.ä. besitzen. 

Die Teilnehmer lernen im Vortrag und in Diskussionen 
das Konzept von Microsoft OS/2 kennen und erhalten 
einen Überblick über die Fähigkeiten und Programmier- 
schnittstellen dieses Betriebssystems. Während des Semi- 
nars haben die Teilnehmer die Möglichkeit, das Gelernte 
anhand von Übungsaufgaben für sich selbst zu überprüfen. 


Ort Datum Tag 
Düsseldorf 19./20.06.89 Mo./Di. 
München 29./30.05.89 Mo./Di. 


Der Microsoft OS/2 Workshop 


Das dreitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmiererfahrungen in einer höheren, 
strukturierten Programmiersprache unter MS-DOS und C- 
Kenntnisse besitzen sowie das MS-OS/2-Einführungssemi- 
nar besucht haben. 

Die Teilnehmer lernen im Vortrag und praktischen 
Übungen am PC Family-API-Programme zu schreiben und 
Device-I/O-Routinen zu erstellen sowie Multitasking-Funk- 
tionen zu nutzen und eigene Dynamic-Link-Bibliotheken zu 
erstellen; außerdem können sie die erweiterten Speicherver- 
waltungsmöglichkeiten des Intel 80286 nutzen und mit Hilfe 
des MS-OS/2 Memory Managers programmieren. Dieses 
Seminar ist übrigens nicht im SDK-Preis enthalten. 


Ort Datum Tag 
Düsseldorf 21./22./23.06.89 Mi./Do./Fr. 
München 31.05./1./2.06.89 Mi./Do./Fr. 


... Termine ... Termine ... Termine 


Das Microsoft Windows Einführungsseminar 


Das zweitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmierkenntnisse in einer höheren Pro- 
grammiersprache wie C, Pascal, o.ä. besitzen. 

Die Teilnehmer lernen im Vortrag und in Diskussionen 
das Konzept von Microsoft Windows kennen und erhalten 
einen Überblick über dessen Fähigkeiten und Program- 
mierschnittstellen. Dieses Seminar ist nicht im SDK-Preis 
enthalten. 


Ort Datum Tag 
Düsseldorf 26./27.06.89 Mo./Di. 
München 05./06.06.89 Mo./Di. 


Der Microsoft Windows Workshop 


Das dreitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmiererfahrungen in einer höheren, 
strukturierten Programmiersprache unter MS-DOS und C- 
Kenntnisse besitzen sowie das Microsoft Windows Einfüh- 
rungsseminar besucht haben. 

Die Teilnehmer lernen im Vortrag und praktischen 
Übungen am PC Benutzerschnittstellen zu erstellen, die 
grafische Programmierschnittstelle zu nutzen, die Routinen 
zum Memory Management anzuwenden und dynamische 
Bibliotheken zu erstellen und zu benutzen. Dieses Seminar 
ist nicht im SDK-Preis enthalten. 


Ort Datum Tag 
Düsseldorf 28./29./30.06.839 Mi./Do./Fr. 
München 07./08./09.06.89 Mi./Do./Fr. 


Microsoft Presentation Manager 
Einführungsseminar 


Dieses Seminar erleichtert das Umsteigen von Microsoft 
Windows auf den Microsoft OS/2 Presentation Manager. 

Der Teilnehmer lernt die Unterschiede zwischen 
Microsoft Windows und dem Microsoft OS/2 Presentation 
Manager kennen und lernt, wie er seine Windows- 
Applikationen auf den PM übertragen kann. 


Ort Datum Tag 
Düsseldorf 19.05.89 Fr. 
München 12.06.89 Di. 
Microsoft LAN Manager 
für Windows-Programmierer 
Ort Datum Tag 
Düsseldorf 16.05.89 Er; 
München 13.06.89 Di. 
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Common-X-Interface: 
Brücke zwischen Unix und PC-Umgebungen 


Hewlett-Packard und Microsoft haben kürzlich mit dem 
Common-X-Interface (CXI) ein grafisches Bediener-Inter- 
face für Unix-Betriebssysteme vorgestellt. Die Bedienungs- 
oberflächen von Unix-Systemen erhalten damit das gleiche 
zweidimensionale Erscheinungsbild wie MS-DOS mit 
Microsoft Windows und MS OS/2 mit dem Presentation 
Manager. Darüber hinaus stellte Hewlett-Packard eine 
separate CXI-Version mit dreidimensionalem Erschei- 
nungsbild vor. 

CXlI stellt für Softwareentwickler Richtlinien und Werk- 
zeuge zur Entwicklung von Anwendungen mit konsistentem 
Bediener-Interface zur Verfügung. Die Gleichartigkeit 
ermöglicht es Anwendern, die mit Microsoft Windows oder 
dem Presentation Manager vertraut sind, durch CXI ohne 
großen Lernaufwand mit jedem Unix-System zu arbeiten. 

CXI basiert auf dem X-Windows-System, einem eta- 
blierten Standard in der Unix-Welt. Es wurde von Hewlett- 
Packard und Microsoft entwickelt. Dies war eine Reaktion 
auf die Forderung der Open Software Foundation nach 
Standardisierung der Bedieneroberfläche von Unix. 


Die Brücke zwischen Unix und PC 


Mit dem Common-X-Interface haben Hewlett-Packard und 
Microsoft ein zuverlässiges Bediener-Interface für Unix- 
Systeme als Brücke zwischen der PC- und der Unix- 
Systemwelt geschaffen. Die Attraktivität des CXI ergibt sich 
aus zwei Gesichtspunkten: Konsistenz mit der Umgebung 
von Microsoft Windows, die Millionen von Computer- 
Anwendern vertraut ist - und sofortige Verfügbarkeit. 
Durch CXI sind Hardware- und Systemanbieter in der 
Lage, ihren Anwendern eine einheitliche Produktlinie über 
die drei Betriebssystem-Umgebungen MS-DOS, MS OS/2 
und Unix zu bieten. Unternehmen, die MS-DOS, MS 0S/2 
und Unix-Systeme unter einem Dach einsetzen, werden 
feststellen, daß die Einarbeitungszeit der Anwender erheb- 
lich verringert wird, weil sie sich nur noch mit einer Bedie- 
nungs-Oberfläche vertraut machen müssen. 


Die CXI-Bestandteile 
CXI besteht aus drei Grundelementen: 


u cinem »Style Guide«, der ein zum MS OS/2 Presen- 
tation Manager konsistentes Verhalten dokumentiert, 

s der HP-X-Widget Anwendungs-Programmier-Interface- 
Spezifikation und -Software (API) sowie 

s» dem HP-Window-Manager, einer Implementation der 
MS OS/2 Presentation Manager-Funktionen. 


Der »Style Guide« bietet flexible Richtlinien bei der 
Bildschirmdarstellung des Bediener-Interface. Softwareent- 
wickler können auf der Basis dieser Richtlinien eigene Vor- 
stellungen bei der Gestaltung ihrer Anwendungs-Bedie- 
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nungsoberflächen realisieren. Die Konsistenz in Layout und 
Verhalten des Bediener-Interfaces wird dabei trotzdem 
gewahrt. 

Der HP-Window-Manager, der gemäß dem CXI-»Style 
Guide« ausgelegt ist, steuert Bewegung, Position und For- 
mat von Fenstern auf dem Bildschirm. 

Hewlett-Packard und Microsoft gaben gleichzeitig mit 
der Vorstellung des CXI bekannt, daß sie gemeinsam den 
Presentation Manager/X für Unix-Systeme als Erweiterung 
von CXI entwickeln. Hewlett-Packard plant außerdem die 
Entwicklung einer HP-NewWave Software-Anwendungs- 
umgebung für Unix-Systeme unter Nutzung von CXI als 
grafisches Bediener-Interface. 


Verfügbarkeit 


Der CXI-Source-Code ist in hohem Grade portabel und 
wird durch Technologie-Lizenzvereinbarungen auf breiter 
Basis verfügbar sein. Der CXI-Style Guide und die API- 
Software sind für Softwareentwickler und Systemhersteller 
sofort lieferbar. Der Window Manager, den Anwender 
benötigen, um Anwendungen laufen zu lassen, wird im 
zweiten Quartal 1989 zur Verfügung stehen. 


CXI und Presentation Manager/X 


Mit Common-X-Interface (CXT) und Presentation Mana- 
ger/X trägt Microsoft der Problematik der Standardisie- 
rung im Software-Bereich Rechnung. Die heutige Situation 
im Computermarkt ist gekennzeichnet von dem Bemühen, 
Anwendern den Komfort einer einheitlichen Bedienerober- 
fläche zu bieten. So ist zum Beispiel bei der Open Software 
Foundation (OSF) und der europäischen X/Open-Gruppe 
die Festlegung eines Standards das vorrangige Ziel. 
Common-X-Interface und Presentation Manager/X 
wurden in gegenseitiger Abstimmung entwickelt und ergän- 
zen sich daher. Sie schlagen die Brücke von MS-DOS und 
MS OS/2 zu Unix-Systemen und bieten folgende Vorteile: 


1. CXI und PM/X versetzen Software-Hersteller und 
OEMS in die Lage, eine einheitliche Produktlinie für 
MS-DOS, MS OS/2 und Unix-Betriebssysteme bereit- 
zustellen. 

2. Unix-Anwendungsprogramme können so ausgelegt wer- 
den, daß sie die gleiche Bedienungsoberfläche und 
Handhabung aufweisen wie Anwendungsprogramme 
unter Microsoft Windows/Presentation Manager. Die 
Anwender werden also größtenteils bereits mit dem 
Bedienungs-Interface vertraut sein, wenn sie Unix-An- 
wendungen einsetzen wollen, die unter CXI laufen. 

3. OEMs und Endanwender können darauf vertrauen, daß 
die Integration von Unix-Systemen in bereits bestehende 
Umgebungen reibungslos verläuft, weil das CXI und das 
PM/X-Interface auf der Mehrheit der schon installier- 
ten Systeme konsistent sein werden. 


Mitteilungen 


Mitteilungen .... Mitteilungen .... Mitteilungen 


4. CXI und der PM/X basieren auf etablierten Standards 
der Unix-Welt, wie zum Beispiel der C-Programmier- 
sprache und X-Windows. Entwickler von Unix-Anwen- 
dungen werden beim Umstieg auf CXI und PM/X also 
weiterhin mit den vertrauten und erprobten Unix-Werk- 
zeugen arbeiten können. 


Warum ist ein Standard bei der Benutzeroberfläche von 
so großer Bedeutung? Die Arbeit mit dem Computer soll 
für den Anwender immer einfacher werden. Dazu gehört, 
daß er sich nicht permanent mit neuen Befehlsstrukturen, 
Funktionen und einem fremden Bildschirmgesicht ausein- 
andersetzen muß. Im Grunde soll er mit nur einer Be- 
dieneroberfläche auf allen Computern arbeiten können. 
Das bringt zwei große Vorteile: 


» Statt zeitraubender und lästiger Einarbeitung sofort 
effektives Arbeiten. 

» Die einfache Handhabung erhöht die Akzeptanz des 
Computers generell. 


Eine einheitliche Benutzeroberfläche ist nicht nur für 
den Anwender von Vorteil. Entwickler von Anwendungen 
mußten sich bisher entscheiden, für welche grafische Benut- 
zeroberfläche sie ihre Programme schreiben. Die Ziel- 
gruppe war begrenzt. Die Herstellung von Anwendungen 
für eine bestimmte Oberfläche ist aber relativ teuer und 
eine Portierung auf andere Umgebungen verursacht hohe 
Kosten. Erweitert sich nun die Zielgruppe durch eine stan- 
dardisierte grafische Benutzeroberfläche auf unterschied- 
lichen Betriebssystemen, ist dies für Software-Hersteller 
eine Möglichkeit, größere Stückzahlen abzusetzen. Damit 
verteilen sich die Entwicklungskosten entsprechend, die 
Anwendungsprogramme werden billiger. 

Bislang haben nur wenige Software-Hersteller mit ihren 
Anwendungen erfolgreich verschiedene Betriebssysteme 
unterstützt. Microsoft ist mit seinen Anwendungen für MS- 
DOS, MS OS/2, Xenix und das Macintosh-Betriebssystem 
eine Ausnahme. 


Microsoft Windows: Ein Standard entsteht 


Microsoft kündigte 1984 Windows an, eine grafische Bild- 
schirmoberfläche für MS-DOS-PCs. Jeden Monat werden 
inzwischen mehr als 50.000 Einheiten Windows ausgeliefert. 
Die Software wird sowohl über den Handel vertrieben als 
auch zusammen mit Hardware ausgeliefert. Installiert ist 
Windows bereits auf Rechnern der Firmen Hewlett- 
Packard, Zenith, IBM, Compaq, Wang, Unisys und NCR. 
Ein weiterer Beweis für die hohe Akzeptanz des Produkts 
im Markt ist sein Einsatz bei großen internationalen Unter- 
nehmen wie zum Beispiel Covia/United Airlines, Arthur 
Anderson, Manufacturers Hanover Trust und Merill Lynch. 
Bis Ende des Jahres 1989 werden voraussichtlich 2,5 Millio- 
nen Microsoft Windows Einheiten installiert sein. Damit ist 
Windows die am meisten verbreitete Benutzeroberfläche 
und der Grafik-Interface-Standard in der MS-DOS-Welt. 


Daß MS-DOS-Systeme im Bereich der Tischeomputer - 
dem größten Segment im Computermarkt - eine vorherr- 
schende Position haben, stellen auch jene Computer-Her- 
steller fest, die Unix-Systeme an Großkunden verkaufen 
wollen. Sie finden dort eine breite Basis an MS-DOS/Win- 
dows-Peresonalcomputer und MS OS/2-Systemen vor, in 
die der Unternehmer viel investiert hat. Er hatte Ausgaben 
in den Bereichen 


Computer-System-Training, 
Anwendungs-Training, 
Dokumentation, 

Trainingshilfen auf Computer-Basis, 
Programme. 


Diese Investitionen kann der Unternehmer nur dann 
schützen, wenn neue Anwendungen den Anwender nicht in 
den Stand des Computerlaien zurückwerfen. Eine durch- 
gängige Produktlinie ist daher ebenso erforderlich wie ein 
Bedienungsstandard. Ob Unix, MS-DOS oder MS OS/2 - 
gefragt ist eine Bedieneroberfläche, die für alle drei 
Betriebssysteme gilt. Bislang gibt es nur viele Standardisie- 
rungsbemühungen, im Unix-Bereich existiert kein einziger 
eindeutiger Standard für ein grafisches High-Level-Bedie- 
ner-Interface. Das X-Windows-System bietet zwar eine 
Standardisierung auf niederer Ebene an, im High-Level 
Bereich klaffte aber bisher eine Lücke. Gefüllt wird sie 
durch das Common-X-Interface und den Presentation 
Manager/X von Microsoft. 

Das Microsoft Betriebssystem OS/2 repräsentiert die 
zweite Generation von PC-Betriebssystemen für den kom- 
merziellen Einsatz und erweitert die in MS-DOS zur Verfü- 
gung stehenden Möglichkeiten. MS OS/2 umfaßt bereits 
eine integrierte Unterstützung für eine grafische Benutzer- 
oberfläche ähnlich Windows. Diese Erweiterung des 
Betriebssystems ist der Presentation Manager. Er basiert 
auf den gleichen Spezifikationen wie Windows. Anwender 
von Windows können daher auf die leistungsstarke MS 
OS/2-Betriebssystem-Umgebung ohne Einarbeitung um- 
steigen. 

Hinsichtlich der führenden Anwendungspakete für die 
Büroautomation wird der Presentation Manager 1989 die 
von unabhängigen Software-Häusern am breitesten unter- 
stützte grafische Bedieneroberfläche sein. Alle führenden 
Software-Hersteller, einschließlich Lotus, Ashton Tate und 
Microsoft selbst, haben Software-Produkte für den Presen- 
tation Manager angekündigt oder bereits vorgestellt. 

Microsoft und Hewlett-Packard haben sich die Aufgabe 
gestellt, eine Netzwerk-Software zu entwickeln, mit der MS- 
DOS, MS OS/2 und Unix-Systeme in einem lokalen Netz- 
werk zusammenarbeiten können. In Anlehnung an den 
LAN Manager des MS OS/2-Betriebssystems wird dieses 
Netzwerkprodukt für Unix den Namen LAN Manager/X 
tragen. 
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Zusammenwirken von MS OS/2 LAN Manager 
und IBM OS/2 LAN Server demonstriert 


Auf der COMDEX-Trade-Show in Las Vegas, Nevada, hat 
Microsoft das direkte Zusammenwirken zwischen dem 
Microsoft OS/2 LAN Manager und dem IBM OS/2 LAN 
Server beeindruckend in der Praxis demonstriert. Microsoft 
führte vor, wie die Anwender LAN Manager-Produkte, 
Workstations, Server, MS-DOS-Computer und MS OS/2- 
Systeme nach ihren speziellen Anforderungen in Verbin- 
dung mit dem IBM OS/2 LAN Server einsetzen können. 

Der MS OS/2 LAN Manager und der IBM OS/2 LAN 
Server basieren auf einheitlichen Standard-Interfaces wie 
dem SMB-Netzwerk-Protokoll, dem NetBIOS-Interface 
sowie dem NetBEUI/DLC-Netzwerk-Transport-Stack. 
Diese Standardschnittstellen ermöglichen es, daß LAN 
Manager und LAN Server ohne Gateways und Protokoll- 
konverter direkt zusammenarbeiten können. Wie Christian 
Wedell, Geschäftsführer der Microsoft GmbH in München- 
Aschheim, unterstrich, »wird das hohe Niveau der direkten 
Interoperabilität einen bedeutenden Einfluß auf das 
Wachstum und die Struktur des PC-Netzwerkmarktes 
haben. Dieses Niveau kann mit herstellerspezifischen Netz- 
werk-Produkten auf der Basis von nichtstandardisierten 
Schnittstellen und Protokollen nicht erreicht werden.« 

Die Funktionen und Schnittstellen, die die Zusam- 
menarbeit zwischen dem LAN Manager und dem LAN Ser- 
ver ermöglichen, sind integrierter Bestandteil des Standard 
LAN Managers. Damit können alle OEM-Anwender des 
LAN Managers ihren Kunden das Zusammenwirken von 
IBM OS/2 LAN Server und Microsoft OS/2 LAN Manager 
bieten. Die Firmen 3Com Corporation und Torus Systems 
Ltd, die den LAN Manager als erste ausliefern, wollen diese 
Konfiguration von LAN Manager und LAN Server forciert 
unterstützen. Eric Benhamou, Vice President und General 
Manager der 3Com »Software Products Division«, sieht 
gegenüber Netzwerk-Lösungen anderer Anbieter einen 
erheblichen Vorteil darin, daß der von seinem Unterneh- 
men angebotene 3+Open LAN Manager mit dem IBM 
OS/2 LAN Server direkt zusammenarbeiten kann. Stephen 
Ives, Managing Director von Torus, ergänzt, daß sein 
Unternehmen eng mit den Wiederverkäufern und Kunden 
kooperieren möchte, um so sicherzustellen, daß der LAN 
Manager gemeinsam mit dem IBM OS/2 LAN Server ein- 
gesetzt werden kann. 

Die Demonstration des »Zusammenspiels« zwischen 
LAN Manager und LAN Server war nur ein Element der 
LAN Manager Expo, die im Rahmen der Las-Vegas- 
COMDEX stattfand. Mehr als ein Dutzend OEM-Firmen 
zeigte unter Einsatz des LAN Managers die Vernetzung von 
über 60 Computern einschließlich PCs unter MS OS/2 und 
MS-DOS, Apple Macintosh Computer, Sun-Workstations, 
DEC VAX Computer und Unix-Systeme. Die eingesetzten 
Netzwerk-Medien umfaßten EtherNet, Token Ring, Arcnet 
und Starlan. Die mehr als 60 Maschinen und vier verschie- 
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denen Netzwerk-Medien waren über eine Reihe von kom- 
merziell verfügbaren Netzwerk-Programmen wie IBM- 
»Token Ring Source Routing Bridge« und »Ungermann 
Bass Net/One Token Ring/EtherNet Data Link Bridge« 
verbunden und bildeten. ein heterogenes LAN Manager 
Netzwerk. 

Des weiteren zeigten mehr als ein Dutzend unabhängi- 
ger Software-Hersteller als spezielle Demonstration der 
Interoperabilität zwischen LAN Server und LAN Manager 
Anwendungen, die transparent in der LAN Manager-/LAN 
Server-Umgebung liefen. Unter diesen Anwendungen sta- 
chen einige Frontend-Anwendungen für den Ashton- 
Tate/Microsoft SQL Server und den SOL Server selbst her- 
vor. 

Um sicherzustellen, daß Systeme, die durch LAN Mana- 
ger-OEMs unterstützt werden, ohne weiteres mit dem IBM 
OS/2 LAN Server zusammenarbeiten, hat Microsoft ein 
»Conformance Certification Program« für LAN Manager 
OEM-Kunden entwickelt. Dieses Programm wird von 
»DWB Associates of Beaverton«, Oregon, durchgeführt. 
Dabei erhalten OEM-Hardwaretreiber nach einer entspre- 
chenden Prüfung ein Zertifikat, das die Interoperabilität 
und Konformität zu Microsofts »Media Access Control«- 
Treiber-Interface bescheinigt. 


Bildschirmhersteller unterstützen den 
Microsoft OS/2 Presentation Manager 


Namhafte unabhängige Hersteller von Bildschirm-Termi- 
nals und Video-Treibersoftware, die im Microsoft OS/2 
Presentation Manager als geräteunabhängige Schnittstelle 
einen signifikanten Fortschritt für die Entwicklung von 
Anwendungen sehen, gaben in diesen Tagen forcierte Ent- 
wicklungspläne zu dessen Unterstützung bekannt. Zu diesen 
Herstellern zählen Firmen wie Chips & Technologies, 
Texas Instruments, Western Digital Imaging, Micro Display 
Systems, Intel, Video-7, Moniterm und Graphic Software 
Systems. 

Sikander Naqvi, General Manager für Grafik-Produkte 
bei Chips & Technologies, kommentierte die Ankündigung 
mit den Worten, daß »Display-Hersteller durch den MS 
OS/2 Presentation Manager eine wesentlich größere Flexi- 
bilität bei der Verbesserung ihrer Bildschirm-Technik 
haben werden. Außerdem sind Anwendungs-Entwickler 
nun nicht mehr gezwungen, Bildschirm-Treiber für alle auf 
dem Markt befindlichen Bildschirme zu entwickeln«. Statt 
dessen müssen die Entwickler nur noch eine Schnittstellen- 
Software für den Presentation-Manager schreiben, dessen 
Treiber den jeweiligen Bildschirm ansteuert. Die daraus 
entstehende Vereinfachung ist ein erheblicher Fortschritt 
für die Industrie. Chips & Technologies hat die Absicht, 
Presentation Manager-Bildschirmtreiber für alle seine Pro- 
dukte anzubieten. Das Unternehmen arbeitet bereits seit 
zwei Jahren mit Microsoft zusammen, um seine Grafik- 
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Produkte speziell für Microsoft Windows und den MS Pre- 
sentation Manager zu verbessern. 

Texas Instruments und Microsoft entwickeln einen Pre- 
sentation Manager-Treiber auf der Basis des weitverbrei- 
teten Grafik-Systemprozessors 34010 und des Texas Instru- 
ments-Grafik-Architektur-(TIGA)-Interface-Standards. 
Nach Darstellung von K. Bala, Vizepräsident der Micropro- 
zessor/Microcontroller-Division von Texas Instruments, 
wird der 34010-Grafikprozessor bevorzugt für Hochlei- 
stungs-PC-Software wie Microsoft Windows und zahlreiche 
CAD-Anwendungen auf dem PC eingesetzt. Texas Instru- 
ments geht ferner davon aus, daß der 34010-Grafikprozes- 
sor zusammen mit dem TIGA-Interface ein Standard bei 
der Anwendung des Presentation Managers wird. Da die 
Unterstützung des Presentation Managers ein integraler 
Bestandteil der PC-Grafik-Strategie von Texas Instruments 
ist, hat sich das Unternehmen darauf festgelegt, Presenta- 
tion Manager-Treiber für PCs auf 34010-Basis zu liefern. 
Dies wird bereits im 1. Quartal 1989 erfolgen. 

Die Grafikkarten »Paradise VGA Plus«, »Paradise 
VGA Plus 16« und »Paradise VGA Professional« von 
Western Digital Imagine unterstützen ebenfalls den Pre- 
sentation Manager. »Paradise Systeme stehen heute als 
Gütesiegel für Videoprodukte in PCs und Workstations. In 
diesem Sinne traten wir seit jeher für Bildschirm-Standards 
im Bereich der Büroautomation ein«, betont Chester A. 
Brown, Vice President und General Manager des Unter- 
nehmens. »Weil wir der Ansicht sind, daß der MS OS/2 
Presentation Manager der nächste Standard im Bereich der 
Betriebssystem-Umgebungen für den Markt der Büroauto- 
mation ist, wird Western Digital Imagine weiterhin eng mit 
Microsoft zusammenarbeiten. Damit wollen wir sicherstel- 
len, daß auch unsere zukünftigen IBM-kompatiblen Pro- 
dukte diese Standards unterstützen«. 

Micro Display Systems hat bereits mit der Auslieferung 
eines Presentation Manager-Treibers für ihre Ganzseiten- 
Bildschirme »Genius Plus« begonnen. Anwender der 
Genius Plus-Bildschirme können die Treiber über das 
»Micro Displays Electronic Bulletin Board« laden. Micro 
Display bietet allen MS OS/2 Systementwicklern die Genius 
Plus- und Genius-II-Monitore zum halben Preis an. 

Charles Fox, Graphic Product Line Marketing Manager 
bei Intel, ist der Meinung, daß der Presentation Manager 
einen völlig neuen Standard in bezug auf die einfache 
Bedienbarkeit von PCs setzt. In Erwartung des Presentation 
Managers hat Intel den 82706-VGA-Controller entwickelt, 
um der Industrie eine 100prozentig IBM-VGA-Gate-Level- 
kompatible Plattform anzubieten. 

Auch Paul Jain, Präsident und Geschäftsführer der 
Firma Video-7, geht davon aus, daß der Presentation Mana- 
ger das bestimmende Grafik-Interface in den Wer Jahren 
sein wird. Video-7 hat deshalb die Entwicklung stark for- 
ciert, um im 1. Quartal 1989 optimierte Presentation Mana- 
ger-Treiber für alle Video-7-Grafikadapter ausliefern zu 
können. Die VGA- und 8514/1-kompatiblen Produkte wer- 


den eine Leistungsfähigkeit und Auflösung bieten, wie sie 
für den effizienten Einsatz des Presentation Managers 
erforderlich sind. 

Moniterm, ein Hersteller von Bildschirmen und Bild- 
schirm-Controllern, wird ebenfalls den Presentation Mana- 
ger umfassend unterstützen. Der mit höchster Priorität 
entwickelte MS OS/2 Presentation Manager-Treiber des 
Unternehmens soll schon Anfang ’89 lieferbar sein. 

Seine besten Ressourcen zur Entwicklung von Firmware 
und Programmierwerkzeugen für den Presentation Mana- 
ger hat auch Graphics Software Systems (GSS) eingesetzt. 
Das Unternehmen, das Grafik-Softwarepakete und Firm- 
ware für PC-Hersteller anbietet, wird eine »Low Over- 
head«-Programmierumgebung für den Presentation Mana- 
ger vertreiben. Daneben wird Firmware zur Verfügung 
gestellt, die es erlaubt, Presentation Manager-Anwendun- 
gen auf verschiedener Hardware für Hochleistungs-Grafik 
laufen zu lassen. 

Um Peripherie-Hersteller bei der Entwicklung von 
Treibern für den MS OS/2 Presentation Manager zu unter- 
stützen, bietet Microsoft ein MS OS/2 Device Driver Deve- 
lopment Kit an, das aus Beispiel-Quellprogrammen, Debug- 
ging-Werkzeugen und einer zugehörigen Dokumentation 
besteht. 


FormMaster: Formulargestaltung 
für den Profi 


Die Gesellschaft für Computer-Anwendungen GCA hat mit 
FormMaster ein Softwarepaket für die professionelle For- 
mulargestaltung vorgestellt. Das unter Windows implemen- 
tierte Paket wurde vom Institute for Information Industry, 
Taipei, einem Spezialisten auf dem Gebiet der PC-Anwen- 
dersoftware, entwickelt. Die deutsche Version des Produkts 
für die Standard-Oberfläche MS-Windows wurde von GCA, 
Ludwigsburg, erstellt und ist seit November lieferbar. 

FormMaster erlaubt die ökonomische Generierung von 
individuellen Formularen am eigenen Arbeitsplatz-PC. Das 
neue System sorgt bei der in vielen Unternehmen sehr auf- 
wendigen Formulargestaltung für massive Produktivitäts- 
fortschritte. 

Ein Formular wird aus grafischen Elementen, Texten 
und Datenfeldern aufgebaut. Es kann ausgedruckt werden 
und als normales Formular genutzt werden. Die Daten- 
felder können jedoch auch auf dem Bildschirm ausgefüllt 
werden, wobei die Daten entweder über die Tastatur oder 
aus Dateien von Standardprogrammen eingelesen werden. 

Eine übersichtliche Menü-Steuerung erlaubt es auch 
dem Neuling in der Windows-Welt, schnell produktiv mit 
dem neuen Tool zu arbeiten. Dabei wird der Anwender 
unterstützt durch Dateiimport-Routinen, vielfältige Edi- 
tierfunktionen und eine große Zahl grafischer Darstel- 
lungsmöglichkeiten, die von horizontalen, vertikalen und 
diagonalen Linien beliebiger Stärke über Rechtecke bis hin 
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zu Kreisen und Ellipsen alle denkbaren Erfordernisse 
abdecken. Besondere Unterstützung gibt FormMaster bei 
Aufgaben, bei denen herkömmliche Desktop Publishing- 
oder Textverarbeitsprogramme versagen. Dazu gehören 
beispielsweise mehrfache Unterteilung von Rechtecken, 
Tabellen, Rechenfunktionen von Datenfeldern, etc. 


WYSIWYG-Darstellung 


Da es beim Entwurf eines Formblattes wichtig ist, sowohl 
einzelne Teile als auch das Gesamtbild direkt am Bild- 
schirm einer Kontrolle auf das bestmögliche Design zu 
unterziehen, bietet FormMaster eine Multiple View-Option, 
mit der der Bildschirminhalt vergrößert oder verkleinert 
werden kann. Mit dem WYSIWVYG-Interface wird eine 
naturgetreue Wiedergabe des Druckbildes auf dem Bild- 
schirm ermöglicht, so daß auf kosten- und zeitintensive 
Probeausdrucke verzichtet werden kann. 

Jedes der verwendeten Form-Elemente ist einzeln bear- 
beit- und abspeicherbar. Grafiken, die aus Grafik-Pro- 
grammen wie Eyestar, Windows Paint oder PC Paintbrush 
zugeladen werden, sowie Datenfelder und Texte können 
einzeln oder stückweise verschoben, in der Größe verändert 
oder inhaltlich modifiziert werden. Die so bearbeiteten 
Module können auch als Komponenten in anderen Formu- 
laren verwandt werden. 

Weitere Features sind die Hilfefunktion, der wahlweise 
Ausdruck von leeren Formularen und die Übertragung von 
Datei-Inhalten in fertige Formblätter. 

Das anwenderfreundliche Produkt ist durch seine spe- 
zielle Ausrichtung auf ein in der betrieblichen Praxis 
bedeutendes Anwendungsgebiet eine Bereicherung des 
Spektrums professioneller Systeme für Aufgaben des 
Desktop Publishing. 


EISA-Entwicklung verläuft nach Plan 
32-Bit-EISA-Anschluß fertiggestellt 


Die Gruppe der Computer-Hersteller, die am 13. Septem- 
ber 1988 die Erweiterte Industriestandard-Architektur 
(EISA) ins Leben rief, kündigte an, daß alle Schlüsselele- 
mente der EISA-Spezifikation - elektrische, mechanische 
und Details der Systemkonfiguration - eingearbeitet und an 
die am Projekt beteiligten Herstellerfirmen verteilt worden 
seien. 

Die Ausarbeitung der EISA-Spezifikation (sie umfaßt 
zur Zeit über 250 Seiten) verläuft planmäßig. Marktfüh- 
rende Computer-Hersteller haben bereits begonnen, auf 
Basis dieser rechtlich nicht geschützten Industriestandard- 
Spezifikation Computersysteme, EISA-Chips, Zusatz-Plati- 
nen und Software-Erweiterungen zu entwickeln. Bis zum 
heutigen Datum haben weltweit mehr als 100 Hersteller die 
vollständige EISA-Spezifikation erhalten. Diese Hersteller 
haben das Ziel, auf EISA basierende Produkte zu ent- 
wickeln. 
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Erste Testversionen der wichtigsten EISA-Chips von der 
Intel Corp., auch »EISA-Chipset« genannt, werden voraus- 
sichtlich im zweiten Quartal dieses Jahres fertiggestellt. 
Erste Lieferungen der neuen Chips von Intel an die Com- 
puter-Hersteller sind für das zweite Halbjahr dieses Jahres 
vorgesehen. Komplette auf EISA basierende PC-Systeme 
und Zusatzprodukte werden Ende des Jahres verfügbar 
sein. 


EISA-Anschluß fertiggestellt 


Die Spezifikation enthält nun z.B. auch die Fertigstellung 
der mechanischen Details für den EISA 32-Bit-Anschluß. 
Dieser neue Anschluß ermöglicht die Installation von 32-Bit 
Hochleistungs-Erweiterungsplatinen in den neuen EISA- 
PCs, die gegen Ende des Jahres verfügbar sein werden. 

Da EISA eine Übermenge des aktuellen 8-/16-Bit-Indu- 
striestandard-Erweiterungsbus (ISA) ist, schützt EISA 
sowohl im professionellen als auch im privaten Anwen- 
dungsbereich die für mehr als 100 Milliarden Dollar getä- 
tigten Investitionen in Hardware, Software, Peripherie und 
Schulung. Damit ist sichergestellt, daß die Anwender auch 
in Zukunft auf Ihre Investitionen bauen können. Der neue 
Anschluß ist für zwei Betriebsmodi ausgelegt: Die Anwen- 
der können sowohl die Vielzahl von verfügbaren 8- und 16- 
Bit-Erweiterungssteckkarten weiter verwenden als auch 
neue 32-Bit-Steckkarten mit ihrer eigenen Geschwindigkeit 
einbauen. 

So wie heute viele Anwender 8-Bit-Karten in 16-Bit- 
Steckplätzen betreiben, werden die Kunden noch über 
Jahre hinaus bestehende und neue 8- und 16-Bit-Karten 
kaufen und einsetzen. Tatsache ist, daß bei zahlreichen 
Zusatzprodukten wie z.B. Modems eine Neuentwicklung als 
32-Bit-Platine keinerlei Vorteile bringen würde und daß 
diese daher weiterhin als 8- oder 16-Bit-Produkte angebo- 
ten werden. 

Der EISA 32-Bit-Anschluß hat die gleiche Größe wie 
der 16-Bit-Anschluß im Industrie-Standard (ISA) und 
nimmt auf der Systemplatine genausoviel Platz ein. Der 
neue Anschluß besitzt unterhalb der 16-Bit-Kontakte eine 
zweite Reihe von Kontakten für 32-Bit-Daten und -Adres- 
sierung. Alle 32-Bit-Anschlüsse sind mit mechanischen Ein- 
rast-Sperren ausgestattet, die verhindern, daß die 8-/16-Bit- 
ISA-Platinen bis zu der unteren Kontaktreihe eingeschoben 
werden. Die neuen EISA 32-Bit-Erweiterungsplatinen sind 
mit entsprechenden Kerben ausgestattet, die die Platine an 
den Sperren vorbeigleiten lassen, um den Anschluß an die 
untere Kontaktreihe herzustellen. 

Der EISA-Anschluß stellt die notwendige Stromversor- 
gung und Masseanschlüsse sowohl für 8-/16-Bit-Platinen als 
auch für 32-Bit-Platinen bereit. Die Stromversorgung und 
Masseleitungen werden sorgfältig durch den Anschluß 
geführt und entsprechen den EMI-Bestimmungen bezüglich 
der elektromagnetischen Abstrahlungs-Interferenz. 

Der Anschluß ist so konstruiert, daß Erweiterungs-Pla- 
tinen problemlos auf der Systemplatine installiert werden 
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können. Bei der Installation ist etwa die gleiche Kraft auf- 
zuwenden wie bei der Installation der zur Zeit gebräuch- 
lichen 16-Bit ISA-Platinen. 

Die Konstruktion des neuen Anschlusses ist ein Beispiel 
für die gemeinsamen Bemühungen von EISA-Herstellern 
und EISA-Anbietern. Burndy Corp., AMP Inc. und andere 
wichtige Verbindungs-Elemente-Hersteller haben sich 
bereits verpflichtet, diese Bauteile zu liefern. Größere 
Stückzahlen werden für das 2. Quartal erwartet. Nach Aus- 
arbeitung der mechanischen Details des EISA-Anschlusses 
arbeiten die Platinen-Hersteller nun intensiv an der Ent- 
wicklung von 32-Bit EISA-Zusatzplatinen. 


EISA-Merkmale 


Viele Anbieter von Erweiterungs-Platinen haben die Vor- 
teile von EISA erkannt: EISA unterstützt höhere Daten- 
übertragungsraten, bietet eine größere Platinenfläche und 
zusätzliche Leistung pro Steckplatz auf der Basis einer 
offenen Industriestandard-Spezifikation. Die zukünftigen 
Produkte für EISA-Platinen werden die Vorteile der Indu- 
striestandard-Architektur, z.B. verbesserte Leistung, An- 
schlußmöglichkeiten und größeren Funktionsumfang, wei- 
terhin nutzen. 


EISA-Background 


Zu den Gründern der EISA-Gruppe gehören die Unter- 
nehmen AST Research, Inc., Compaq Computer Corpora- 
tion, Epson America, Inc, Hewlett-Packard Co., NEC 
Information Systems, Inc., Ing. C. Olivetti & Co., Tandy 
Corporation, Wyse Technology und Zenith Data Systems. 

EISA ist die 32-Bit-Weiterentwicklung des 8-/16-Bit- 
Erweiterungsbus im Industrie-Standard. Aufgrund der 
größeren Bandbreite bei der Datenübertragung ermöglicht 
EISA den PC-Herstellern die Entwicklung von Produkten, 
die die zukünftigen anspruchsvollen Anwendungen wie z.B. 
das Arbeiten im Rechnerverbund unterstützen. Die Kom- 
patibilität zu den derzeit 20 Millionen installierten PCs im 
Industrie-Standard sowie die Anschlußmöglichkeiten an 
Minis und Mainframes bleiben dabei erhalten. 

EISA ist ein offener 32-Bit I/O-Bus, der beim Einsatz in 
einem entsprechenden 32-Bit-PC im Intel 80386-Prozessor 
entstehende Rechnerverbund-Anwendungen unterstützt, 
z.B. LAN-Netzwerke, Kommunikations-Gateways, Daten- 
bank-Anwendungen mit Multi-User-Betrieb sowie Trans- 
aktionsverarbeitung. EISA bietet Speicheradressierung und 
Datenbus-Anschlüsse mit vollem 32-Bit-Funktionsumfang 
und unterstützt dadurch den Speicherbereich jenseits von 16 
Mbyte. EISA bietet außerdem sowohl direkten 32-Bit-DMA 
als auch 32-Bit Bus-Master-Support. 

Zu den zusätzlichen Funktionen gehören: programmier- 
bare Platinen-Einstellung für die automatische Konfigura- 
tion von EISA-Platinen und die softwaregestützte Konfigu- 
ration von vorhandenen ISA- und zukünftigen EISA-Plati- 
nen, die über Schalter programmierbar sind. 


Neue Produkte von 3Com auf der CeBIT’89 


3Com stellt auf der diesjährigen CeBIT eine Reihe von 
neuen Produkten vor: 


1. 3Server/402 - ein mit 320 Mbyte Plattenkapazität ausge- 
statteter Server der 3S/400-Familie mit Backup-Mög- 
lichkeit und externer Speichererweiterung auf rund 2 
Gigabyte. 

2. 3+Open Internet - eine Erweiterung der 3+Open-Pro- 
duktfamilie für die Internetzwerk-Kommunikation im 
OS/2. 3+Open Internet erfüllt die gleichen Funktionen 
im OS/2 wie 3+Route im DOS. Netzwerke können 
transparent über Standard-Telefonleitungen, speziell 
zugeteilte Hochgeschwindigkeitsleitungen oder Null- 
Modem-Verbindungen miteinander kommunizieren. 
Mit hoher Geschwindigkeit sind Ethernet- und Token 
Ring-Pakete zwischen den Netzwerken übertragbar. 


3. 3+0Open Mail - eine Erweiterung der 3+Open-Familie. 
Sie schafft die Möglichkeit der Kommunikation (E- 
Mail) zwischen Apple, DOS- und OS/2-Workstations. 
Es ist ein Store- und Foreward-System, bei dem elektro- 
nische Post auch bei ausgeschalteter Arbeitsstation zu- 
gestellt werden kann. Über 3+Open Internet kann eine 
WAN-Mail-Kommunikation realisiert werden. 


4. 3+Open LAN Secure - ein Programm zur Erhöhung der 
Netzwerk-Sicherheit mit Zugriffskontrolle über ein 
neues Paßwort-System. 


5. EtherLink/SE - eine Netzwerk-Karte, die dem Mac- 
intosh/SE den Zugang zum Ethernet eröffnet. Sie 
ergänzt die vorhandenen 3Com-Macintosh-Produkte. 


6. Maxess SNA-Gateway - ein Hochleistungs-Gateway für 
die SNA-3270-Terminal-Emulation zur Programm-zu- 
Programm-Kommunikation LU 6.2 (Peer-to-Peer). 
APIs, die als Programmschnittstellen dienen, werden 
unterstützt, 32 Sessionen sind gleichzeitig möglich. 

7. 3+Open LAN Vision - die neue Bezeichnung für LAN 
View - ein LAN-Management-Werkzeug für statistische 
Aufgaben in der Netzwerk-Überwachung für Worksta- 
tions, Server und Zugriffsrechte; basiert auf dem OS/2- 
Presentation-Manager. 


Vorankündigung: 

Im Sommer 1989 werden zwei neue Produkte aus der 
Kooperation von 3Com mit der französischen Firma 
Reseaux lieferbar sein. Sie verbessern weltweite E-Mail- 
Verbindungen. Die Produkte 3+Open Reach/X.400 und 
3+Open Internet/X.25 können PCs, PS/2-Systeme 
Macintosh und andere Rechner international verbinden. 
Mit den Netzwerk-Betriebssystemen 3+ und 3+Open 
LAN Manager wird die Kommunikation mit den unter- 
schiedlichsten E-Mail-Systemen, wie PROFS von IBM, 
All-In-1 von DEC, Telemail und Telenet und Atlas 400 
von Transpac möglich. 
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Mehr Speicher mit XMS und HMA: 


64 Kbyte mehr Speicher adressieren unter DOS 


Jeder weiß, daß der gesamte von einem Intel 
8086- oder 8088-Mikroprozessor ansprechbare 
Speicherbereich 1 Mbyte groß ist. Es wird auch 
oft angenommen, daß ein Intel 80286 oder 80386 
im Real Adress Modus ebenso nur 1 Mbyte 
ansprechen kann, aber dies ist nicht richtig. 
Eine genaue Betrachtung des Aufbaus der 
80286- und 80386-Mikroprozessoren zeigt, daß 
es möglich ist fast 64 Kbyte mehr an Speicher zu 
adressieren. 


Mit geringem Zusatzaufwand ist es den unter DOS laufen- 
den Programmen möglich, diesen zusätzlichen Speicher zu 
nutzen. Dieser Artikel zeigt die Konventionen, die zum 
Ansprechen dieses Extraspeichers eingehalten werden müs- 
sen, und beschreibt die auftretenden Probleme. 


Der obere Speicherbereich 


Dieser zusätzliche Speicher wird der obere Speicherbereich 
genannt (HMA oder High Memory Area). Seine maximale 
Größe ist 64 Kbyte minus 16 Byte. Um ihn anzusprechen, 
muß bei einem 80286 oder 80386 die Adreßleitung A20 im 
Real Adress Modus aktiviert werden. Die Prozessoren 8088 
und 8086 haben beide 20 Adreßleitungen (AO - A19), was 
einen ansprechbaren Speicherbereich von 220 Bytes oder 
1 Mbyte ergibt. 

Für diese Diskussion ist die Unterscheidung zwischen 
Speicherzellen und Speicheradressen sehr wichtig. Speicher- 
zellen starten mit 0 und sind der Reihe nach bis zur oberen 
Grenze des Speichers durchnumeriert. Es besteht eine 
»Eins zu Eins«-Übereinstimmung zwischen Speicherzellen 
und den tatsächlich vorhandenen Speicherbausteinen. 

Die Speicheradressen sind dagegen ein anderer Weg, 
um dieselbe Speicherzelle anzusprechen. Sie bestehen aus 
zwei Teilen, einem 16-Bit-Segment und einem 16-Bit-Off- 
set. Im Real Adress Modus beginnt alle 10h Bytes ein neues 
Segment im Speicher. Zum Beispiel beginnt das Segment 
1234h an der Stelle 1234h * 10h oder 12340h des Speichers. 
Ist ein Offset mit angegeben, so wird er einfach zur Start- 
adresse des Segmentes hinzuaddiert. Die Adresse 1234: 
5678h zeigt also auf die Speicherzelle 12340h + 5678h oder 
179B8h (Bild 1). 

Der 80286/80386 besitzt mehrere AdreBleitungen und 
kann, wenn er im Protected Modus arbeitet, mehr Speicher 
adressieren. Im Real Adress Modus ist die einundzwanzig- 
ste Adreßleitung A20 deaktiviert, womit der Speicherbe- 
reich auf genau die Größe wie beim 8088 oder 8086 be- 
schränkt ist. Jedesmal wenn der Prozessor auf Speicherbe- 
reiche über 1 Mbyte zugreifen will, läuft er auf den Beginn 
des Speichers (Adresse 0) über. 

Wenn sich ein Computer wie der IBM PC/AT oder der 
Compaq 386 im Real Adress Modus befindet, können Sie 
die Adreßleitung A20 aktivieren oder deaktivieren. 
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FFFF :Dß8Fh 
FFFF :BABEh 


2008 :0082 
2080::0881h 
8008 : 88B0h 


Speicheradressen 


Unteres 
Speicherende 


Speicherzellen 


Bild 1: Speicherzellen und Speicheradressen. 


Ist die AdreBleitung A20 aktiviert, führen Versuche, den 
Speicher über 1 Mbyte anzusprechen, nicht zu einem 
Überlauf auf den Anfang. Vielmehr ist es möglich, über die 
1-Mbyte-Grenze in den Extended Speicher zu gelangen. 

Verdeutlichen Sie sich das folgende Beispiel. Bei der 
Benützung der Intel Real Modus-Adressierung zeigt die 
Adresse FFFF:OFh auf die Speicherzelle FFFFFh, die 
gerade 1 Byte unter der Mbyte Grenze liegt (Tabelle 1A). 
Dies ist die Obergrenze, die mit einer 20-Bit-Adressierung 
erreicht werden kann. Die Adresse FFFF:10h zeigt logi- 
scherweise auf die Adresse 100000h, welches das Byte an 
der Mbyte Grenze ist. Da wir aber nur 20 Bits gültige Infor- 
mationen haben, wird die 1, die an der 21. Position (A20) 
ist, ignoriert. Daher zeigt die Adresse auf die Speicherzelle 
Oh (Tabelle IB und Bild 2). 

Wird die Speicherleitung A20 aktiviert, gibt es keinen 
Überlauf, da das benötigte 21. Adreßbit zur Verfügung 
steht. Dies bedeutet, daß die Adresse FFFF:10h tatsächlich 
der Adresse 100000h entspricht (Tabelle 1C). 

Die Konventionen für die Adressierung im Real Adress 
Modus enden mit der Adresse FFFF:FFFFh, was 10FFEFh 
entspricht. So enden wir 64 Kbyte minus 16 Byte über der 
Mbyte-Grenze (Tabelle ID). Dieser zusätzliche Speicher 
wird High Memory Area (oberer Speicherbereich) genannt 
(HMA). 


Speicherverwaltung 


A) 

FFFF:000FH = 
(FFFFH*10H)+000FH 
FFFFOH+0000FH 
FFFFFH = 

11111111111111111111B [mit 29 Bits] 


B) 

FFFF:0010H = 
(FFFFH*10H)+09010H 
FFFFOH+09010H = 
1090000H = 

00000000000000000000B [mit 29 Bits] 

(Bewirkt Überlauf zurück an Speicherzelle 0000:0000) 


C) 
FFFF:0010H = 

100000000000000000000B [mit 21 Bits] 
(Bewirkt erweiterteten Zugriff oberhalb 1 Mbyte) 


D) 

FFFF:FFFFH = 
(FFFFH*10H)+FFFFH = 
FFFFOH+OFFFFH = 
10FFFEFH = 


Tabelle 1A bis 1D: Adressierungskonventionen von Intel. 


Speicherende 
überlaufen. 


Übergelaufene 
Speicher- 
adressen 


Speicher- Speicher- 
zellen adressen 


Bild 2: Speicherüberlauf 


HMA-Besonderheiten 


Einige Aspekte der HMA unterscheidet diesen Bereich von 
normalen Speichersegmenten. Während normale Speicher- 
segmente immer verfügbar sind, kann der obere Speicher- 
bereich nur angesprochen werden, wenn die Adreßleitung 
A20 aktiviert ist. Ein weiterer Unterschied ist, daß dieser 
Bereich nicht an einer Segmentgrenze beginnt, sondern 16 
Byte nach dem Segment FFFFh. 

Der wichtigste Unterschied ist aber, daß dieser Bereich 
nicht unterteilt werden kann, da kein Segment mehr in die- 
sem Bereich beginnt. Deshalb kann dieser Bereich nicht von 
mehreren verschiedenen Programmen zur selben Zeit 
genutzt werden. 

In der Theorie ist die Nutzung des HMA ganz einfach. 
Sie brauchen nur ein Programm in den ersten Teil des 
Expanded Memory verschieben, die Adreßleitung A20 akti- 
vieren und zu einer Speicherzelle über der Adresse 
FFFF:10h springen. Einige Besonderheiten lassen es aber 
ratsam erscheinen, Einschränkungen zu machen. 


HMA-Probleme 


Im folgenden werden nähere Betrachtungen der HMA- 
Besonderheiten angestellt. 

Ansprechen der A20-Adreßleitung: Die Vorgehensweise 
des Aktivierens der AdreBleitung A20 weicht von Computer 
zu Computer ab. Einige Computer verfügen nicht einmal 
über diese Adreßleitung. Zu unterscheiden, welchen Com- 
puter Sie verwenden, und wie es möglich ist, die AdreBlei- 
tung A20 anzusprechen, ist ein schwieriges Unternehmen. 
Deshalb ist eine einheitliche, vom Computer unabhängige 
Möglichkeit gefordert, um diese Ressource anzusprechen. 
Belegen des HMA: Den oberen Speicherbereich muß man 
sich als völlig ungeschützte Ressource vorstellen. Da er nur 
in einem Segment sein kann, kann er nicht auf mehrere 
Programme zur selben Zeit verteilt werden. Da DOS kein 
Multitasking-Betriebssystem ist, kann es sowohl TSR-Pro- 
gramme als auch Einheitenreiber geben, die Konflikte ver- 
ursachen können, wenn sie diese Ressource belegen. Des- 
halb ist ein Schema für das Belegen und Freigeben der 
HMA erforderlich. 

Schutz der HMA vor versehentlichem Überschreiben: Eini- 
ge TSR-Programme und Einheiten-Treiber, wie zum Bei- 
spiel IBMs VDISK-Programm, belegen einfach den unteren 
Teil der HMA und legen dort ihre Daten ab. Ist einer die- 
ser Treiber installiert, kann die HMA nicht genutzt werden. 
Andere Treiber, wie etwa ältere Versionen von Microsofts 
RAMDrive, allokieren Extended Memory von oben nach 
unten. Solange sie 64 Kbyte freilassen, ist die HMA verfüg- 
bar. Ist aber die HMA aktiv, so muß sie vom Überschreiben 
durch solche Programme geschützt werden. 

Feststellen der Existenz der HMA: Es müssen mindestens 
64 Kbyte Extended Memory zur Verfügung stehen, um die 
HMA zu unterstützen. Dieser Zustand muß zuerst über- 
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prüft werden. Ein weiterer Test muß unternommen werden, 
um festzustellen, ob die Adreßleitung A20 aktiviert und 
deaktiviert werden kann. 

Priorisierung der HMA Benutzung: Wenn sich ein DOS- 
Einheiten-Treiber oder ein TSR-Programm in die HMA 
verschiebt, wird der Speicherbereich, den dieses Programm 
unter der 640-Kbyte-Grenze belegen würde, für andere 
Programme frei. Stellen Sie sich den Zustand vor, wenn 
zwei TSR-Programme, die die HMA benutzen könnten, 
installiert werden. Bedenken Sie, daß nur ein Programm 
jeweils die HMA benutzen kann. Nehmen wir an, das erste 
Programm kann 50 Kbyte in die HMA verlegen, das zweite 
hingegen 62 (Bild 3). Wenn das zweite in die HMA ver- 
schoben wird, so sind zusätzlich 12 Kbyte im Speicher unter 
640 Kbyte frei. Der Benutzer benötigt eine Möglichkeit, um 
aus einer solchen Situation das Beste zu machen. 

Die Besonderheiten der HMA bereiten dem DOS-Pro- 
grammierer einige lösbare Probleme. Als Microsoft diesen 
Speicherbereich zuerst nutzen wollte, erkannte die Firma, 
das eine Standardmethode zum Ansprechen des Speichers 
entwickelt werden muß, bevor dieser Bereich größere Nut- 
zung finden kann. 


XMS als Lösung 


Im Juli 1988 veröffentlichten Microsoft, Intel, Lotus und 
andere Softwarehäuser die DOS Extended Memory Spezifi- 
kation (XMS) Version 2.0. XMS erlaubt es den DOS Pro- 
grammierern, alle Teile des Extended Memory, ein- 
schließlich der HMA, effizient zu nutzen. Ein XMS-Treiber 
löst zwei der wichtigsten HMA-Probleme, das maschinen- 
unabhängige Umschalten der Adreßleitung A20 und das 
gleichzeitige Nutzen der HMA von mehreren Programmen. 

Zusätzlich zur HMA-Unterstützung erlaubt XMS Pro- 
grammen, große Mengen von Daten im Extended Memory 
zu speichern. Der Rest dieses Artikels bezieht sich aber nur 
auf den HMA-spezifischen Teil von XMS. Programmierer 
können die komplette Dokumentation und den HIMEM. 
SYS-Treiber von Microsoft beziehen. 


Nutzung der HMA 


DOS-Programmierer müssen vor der Nutzung der HMA 
folgendes unternehmen: 
u Feststellen, ob ein XMS-Treiber vorhanden ist. 
» Adresse der Kontrollfunktion des Treibers feststellen. 
ı HMA anfordern. 
Erlaubt der XMS-Treiber Zugriff auf die HMA, so kann 
das Programm: 
die Adreßleitung A20 aktivieren, 
bis zu 64 Kbyte Programm in die HMA kopieren, 
ausführen, 
die Adreßleitung A20 deaktivieren, 
HMA freigeben und 
beenden. 
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14 Kb nicht 
nutzbar 


518Kb Frei 


Verschieben 
des 1. TSR 


Verschieben 
des 2. TSR 


Bild 3: Optimierung der HMA für den Einsatz von TSR-Pro- 
grammen. 


Der Multiplexinterrupt 2Fh wird sowohl zum Feststellen 
der Anwesenheit des Treibers als auch zum Anfordern der 
Adresse der Kontrollfunktion benützt. Das Aufrufen des 
Interruptes 2Fh mit einem Wert 4300h im Register AX gibt 
den Wert 80h im Register AL zurück, falls der XMS-Trei- 
ber vorhanden ist (Listing 1). 


;‚ Ist ein XMS-Treiber installiert? 


mov ax,4500h 

int 2Fh 

cmp al,80h 

jne KeinXMSTreiber 


Listing 1: Feststellen, ob ein XMS-Treiber installiert ist. 


mov ax,4310h 

int 2Fh 

mov word ptr [XMSControl],bx ; XMSControl 
; ist ein DWORD 

mov word ptr [XMSControl],es 


Listing 2: Die Kontrollfunktion des XMS-Treibers heraus- 
finden. 


Speicherverwaltung 


; Hole die Versionsnummer des XMS-Treibers 
mov ah,80h 
call L[XMSControl] ; Hole XMS-Versionsnummer 


Listing 3: Aufruf einer XMS-Funktion. 


Funktion Beschreibung 


00h Hole XMS-Versionsnummer 

01h HMSanfordern 

02h HMS freigeben 

05h A20 global ermöglichen 

04h A2O global sperren 

05h A20 lokal ermöglichen 

06h A20 lokal sperren 

07h A220 abfragen 

08h Freien Extended Memory abfragen 
09h Extended Memory Block allokieren 
0Ah Extended Memory Block freigeben 
0Bh Extended Memory Block verschieben 
0Ch Extended Memory Block sperren 
0Dh Extended Memory Block lösen 

0Eh Hole Handle-Information 

0Fh Extended Memory Block reallokieren 
10h Oberen Speicherblock anfordern 

11h Oberen Speicherblock freigeben 


Tabelle 1: Die Funktionen der XMS-Programmierschnittstelle. 


Das Aufrufen des Interrupts 2Fh mit einem Wert 4310h 
im Register AX gibt die Adresse der Kontrollfunktion des 
Treibers in der Registerkombination ES:BX zurück (Listing 
2). Programme können die XMS-Funktionen aufrufen, 
indem sie das Register AH mit einem der 18 XMS-Funk- 
tionsnummern laden und dann die Kontrollfunktion auf- 
rufen (Listing 3). Für den Zugriff auf die HMA werden nur 
die Funktionen 0 bis 4 benötigt. Tabelle 1 zeigt die 18 XMS- 
Funktionen. 

DOS Applikationsprogramme können die HMA anfor- 
dern, indem sie die Kontrollfunktion mit AH = 01h 
(Request HMA) und DX=FFFFh aufrufen. TSR-Program- 
me müssen das Register DX unterschiedlich vorbelegen, 
wie wir später noch sehen werden. Kehrt der Funktions- 
aufruf mit dem Wert 1 im Register AX zurück, ist der 
Zugriff auf die HMA erlaubt. Sie können dann die Funktion 
3 (GlobalEnableA20) aufrufen, um die Adreßleitung A20 
des Computers zu aktivieren. Nachdem die Adreßleitung 
erfolgreich aktiviert wurde, kann das Programm den zusätz- 
lichen Speicherbereich nach Belieben nutzen. Normaler- 
weise wird es möglichst viele Teile seines Programms oder 
der Daten verschieben, um Speicherbereich unter 640 Kbyte 
für dynamische Programmteile oder Daten freizubekom- 
men. 


Am Programmende muß das Programm die XMS-Funk- 
tion 4 (GlobalDisableA20) aufrufen, um die AdreBleitung 
A20 zu deaktivieren. Einige ältere DOS-Programme ver- 
trauen auf den Adreßüberlauf, und bringen das System zum 
Absturz, wenn die Adreßleitung A20 aktiviert ist, während 
sie laufen. Vor dem Ende muß das Programm die HMA 
noch freigeben, indem es die XMS-Funktion 2 (Release 
HMA) aufruft. 


Priorisierung der HMA 


Lassen Sie uns zu dem Problem der Priorisierung des HMA 
zurückkommen, wenn mehrere TSR installiert sind, die alle 
auf die HMA zurückgreifen. Der XMS-Treiber wird durch 
eine Zeile ähnlich 

DEVICE=HIMEM.SYS 

in der Datei CONFIG.SYS installiert. Diese Zeile darf 
einen optionalen Parameter 
/HMAMIN= 

enthalten. Dieser Parameter gibt die minimale Speicher- 
größe an, die ein TSR-Programm anfordern muß, um Zu- 
gang zur HMA zu erhalten. 

Ein TSR-Programm muß zusätzlich vor dem Aufruf der 
XMS-Funktion 1 (Request HMA) die Größe des benötig- 
ten HMA-Speichers in Bytes im Register DX angeben. Der 
XMS-Treiber vergleicht diese Größe mit der Angabe von 
/HMAMINS=. Ist die Anforderung größer, bekommt das 
TSR-Programm die HMA zugeteilt. Ist zum Beispiel 
DEVICE=HIMEM.SYS /HMAMIN=55 

in der Datei CONFIG.SYS enthalten, so erhalten nur 
Programme, die 55 oder mehr Kbyte anfordern, Zugang zur 
HMA. Beachten Sie, daß dieses Problem nicht die DOS- 
Applikationen betrifft, da sie die HMA freigeben, bevor sie 
beenden. Da sie sich nicht um die Priorität kümmern müs- 
sen, sollten sie das Register DX mit FFFFh laden bevor sie 
die Funktion 1 (Request HMA) des XMS aufrufen. Hier- 
durch umgehen sie die Prüfung. 

Da einige Programme sich auf den Adreßüberlauf 
verlassen, müssen TSR-Programme, die die HMA benut- 
zen, die Adreßleitung A20 deaktivieren, bevor sie die Kon- 
trolle wieder abgeben. Das erfordert, daß diese Programme 
eine kleine Routine unter der 640-Kbyte-Grenze haben 
müssen, die die Adreßleitung A20 aktiviert und dann den 
Programmteil in der HMA anspringt, wenn das TSR-Pro- 
gramm aktiviert wird. Beim Beenden des TSR-Programms 
muß es eine andere kleine Routine unter der 640-Kbyte- 
Grenze anspringen, die die Adreßleitung A20 deaktiviert 
und dann die Kontrolle abgibt. 


HIMEM.SYS 


Microsofts XMS-Treiber HIMEM.SYS ist in dem XMS 
Developers Kit enthalten. HIMEM.SYS Version 2.04 ist ein 
vollständiger XMS-Treiber, der Unterstützung bei der 
Umschaltung der AdreßBleitung A20 für eine Reihe von 
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Computern bietet, einschließlich der Familien IBM PC und 
PS/2 und der Kompatiblen. 

Eine frühere Version von HIMEM.SYS (Version 1.1) ist 
auch im Lieferumfang von Microsoft Windows/286 und 
Microsoft Windows/386 der Version 2.1 enthalten. Dieser 
Treiber unterstützt nur die ersten 9 der 18 XMS-Funktio- 
nen, was bedeutet, daß alle HMA-Funktionen unterstützt 
werden. 
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Buchbesprechungen 


Bücher zu OS/2 und Microsoft Word 


Wir haben uns diesmal mit unseren Buchbesprechungen 
auf die beiden Themen OS/2 und Microsoft Word konzen- 
triert, wobei wir Bücher ausgesucht haben, die sich haupt- 
sächlich mit den Problemen des Anwenders beschäftigen, 
denn auf den Gebieten OS/2 und Word müssen auch viele 
Programmierer die Bedienung erst noch lernen. 


0S/2 

Ein reines Buch für den OS/2-Anwender hat Frank Piefke 
mit dem »OS/2-BS/2: Anwenderbuch« vorgelegt, so konnte 
er sich denn auch den geschichtlichen Einstieg nicht ver- 
kneifen. Danach folgt dann in acht logisch gegliederten 
Kapiteln die übersichtliche Beschreibung der Möglichkeiten 
und Befehle von OS/2 Version 1.0. Was für den Anfänger 
dabei zu schwierig oder unwichtig sein könnte, wurde in 
Kursivschrift gedruckt. Obwohl es sich bei diesem Buch 
nicht um eine reine Schulung handelt, befinden sich am 
Ende jedes Kapitels ein paar Aufgaben, die eine Selbstprü- 
fung des Kenntnisstands ermöglichen. 


Frank Piefke: »OS/2-BS/2: Anwenderbuch«, Heidelberg, 
Hüthig Verlag 1988; 424 Seiten; ISBN 3-7785-1610-8; 
DM 58,-. 


Die beiden nun folgenden, ähnlich angelegten Bücher aus 
der Düsseldorfer Szene gehen da etwas weiter. Die beiden 
Autoren Schieb und Tischer (letzterer den MSJ-Lesern 
sicherlich wohlbekannt) gehen nach einer Vorstellung von 
OS/2 Version 1.0 und der Installation desselben auf alle 
Befehle im einzelnen ein, um dann auf die Stapelverarbei- 
tung und die Konfiguration des System zu kommen. Als 
wichtiger Bestandteil des Buches werden aber auch die 
technischen Grundlagen und die Programmierung unter 
OS/2 beschrieben. 


Jörg Schieb, Michael Tischer: »Das große Buch zu OS/2«, 
Düsseldorf, Data Becker, 1988; 460 Seiten; ISBN 3-89011- 
212-9; DM 49,-. 


Einen ähnlichen Aufbau hat diese aus dem amerikanischen 
übersetzte Beschreibung von OS/2 »Arbeiten mit 0S/2 & 
BS/2«. Sie reißt die Programmierung unter OS/2 jedoch 
nur an. Besonders nutzbringend wurden die Buchdeckel 
gestaltet: klappt man das Buch vorn oder hinten auf, findet 
man eine kurze Beschreibung der OS/2-Befehle mit Syn- 
taxangabe. 


J. Robbins, M.A. Beisecker, W. Schellenberger: »Arbeiten mit 
0S/2 & BS/2«, Düsseldorf, Sybex Verlag, 439 Seiten; ISBN 
3-88745-656-4; DM 59,-. 


Microsoft Word 


Dies ist keine Buchbesprechung im eigentlichen Sinne, son- 
dern nur eine Empfehlung: Wie könnte ich als Autor (oder 


auch mein Redaktionskollege Jürgensmeier) das Word- 
Lexikon objektiv beurteilen?! Dennoch wollen wir Ihnen die 
Existenz dieses Buches nicht vorenthalten. 

Das Lexikon ist, wie der Name schon andeutet, alpha- 
betisch aufgebaut. Es bietet auf 631 Seiten zu (nahezu) 
jedem Problem, das bei der Arbeit mit Word 4.0 auftreten 
kann, ein Stichwort mit ausführlichen Erklärungen. Dabei 
erleichtern die übersichtliche Gliederung und die vielen 
Beispiele die schnelle Lösung eines Problems. Breiten 
Raum nehmen vor allem die oft vernachlässigten Themen 
Druckformatvorlagen und Makros ein, und auch auf die 
Beschreibung der Fehlermeldungen wurde großer Wert 
gelegt. Wenn man den Aussagen eines Leserbriefs glauben 
schenken darf, dann wird im diesem Buch »klar und 
erschöpfend die ja doch nicht ganz einfache Problematik 
von Word 4.0 handlich und praktikabel dargestellt«. 


Hartmut Niemeier, Marianne Nuß* »Word 4.0 Lexikon«, 
München: Markt&Technik Verlag, 1988; 631 Seiten; ISBN 3- 
89090-621-4; DM 79,-. 


Einen engeren Bereich von Word 4.0 betrachtet das Auto- 
renteam Förster/Zwernemann: Hauptsächlich sind es die 
Makroprogrammierung, Druckformatvorlagen, Textbau- 
steine, Formularerstellung, Serienbriefe und der Druck von 
Etiketten. 

Die einzelnen Themen werden Schritt für Schritt erklärt 
und können so leicht nachvollzogen werden. Auf der mit- 
gelieferten Diskette befinden sich außerdem nahezu alle 
Druckformate sowie die drei großen Makroprogramme 
datenVERWALTER, etikettenASSISTEMT und reise- 
kostenVERWALTER, die sofort in Gebrauch genommen 
werden können. 


Hans-Peter Förster, Martin Zwernemann: »Makroprogramme, 
Standardformate und Musterformulare mit Word 4.0«, Würz- 
burg: Vogel Verlag, 1988; 144 Seiten; inkl. Diskette; ISBN 3- 
8023-0246-X; DM 48,-. 


Noch mehr ins Detail geht Gabi Broszat in ihrem Buch 
»Word Makros für die tägliche Arbeit mit MS-Word«: Sie 
beschränkt sich allein auf die Darstellung der Makros. 
Dabei wurde das Buch so angelegt, daß auch der blutigste 
Laie den großen Nutzen von Makros erkennen wird und 
nach kurzer Zeit eigene Makros zumindest aufzeichnet. 

Doch auch die Makro-Kenner kommen nicht zu kurz. 
Sie werden ihre Freude sowohl an den kleinen nützlichen 
Makros haben als auch die komplizierten auf den hinteren 
Seiten als Anregungen für eigene Makros hernehmen. Im 
übrigen sind auf der beigelegten Diskette alle Makros ein- 
satzfertig für den sofortigen Einsatz enthalten. 


Gabi Broszat: »Word Makros für die tägliche Arbeit mit MS- 
Word«, München: Systhema Verlag, 1989; ca. 180 Seiten; inkl. 
Diskette; ISBN 3-89390-303-8. 
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PC Intern: 


Die Speicherverwaltung von DOS 


In diesem Auszug aus dem Buch »PC Intern« 
erläutert Michael Tischer die Speicherverwal- 
tung und den Aufbau der Memory Control 
Blocks von DOS. 


Aus der Sicht von DOS unterteilt sich der maximal 640 
KByte große Hauptspeicher eines PC in zwei (logische) 
Bereiche. Der erste Bereich dient ihm selbst und wird des- 
halb als Betriebssystembereich bezeichnet. Er beginnt an 
der untersten RAM-Speicherstelle, an der Adresse 
0000:0000 und enthält neben der Interrupt-Vektortabelle 
interne Tabellen, Puffer, Variablenspeicher und den resi- 
denten Betriebssystemcode. Dazu zählen unter anderem die 
fest in das System eingebundenen Geräte-Treiber sowie das 
Systemmodul, das den Programmcode für die DOS-Funk- 
tionen enthält, die über den Interrupt 21h aufgerufen wer- 
den können. Die Größe dieses Bereichs hängt von der 
DOS-Version, der Größe der installierten Gerätetreiber 
und anderen Faktoren wie z.B. der Anzahl der Plattenpuffer 
ab. 

Der zweite, weitaus größere Bereich wird als Transient 
Program Area (TPA) bezeichnet. Er nimmt die auszufüh- 
renden Programme nebst den dazugehörigen Environment- 
Blöcken auf und hat seinen Anfang unmittelbar hinter dem 
Betriebssystembereich. Je nach den Speicheranforderungen 
der einzelnen Programme teilt DOS ihnen einen unter- 
schiedlich großen Speicherbereich zu. Um die so allokierten 
Speicherbereiche zur verwalten, stellt DOS ihnen jeweils 
einen Datenblock voran, der in der DOS-Terminologie als 
Memory Control Block (MCB) bezeichnet wird. Er ist 16 
Bytes (ein Paragraph) groß, beginnt immer an einer durch 
16 teilbaren Adresse und geht dem allokierten Speicher- 
bereich unmittelbar voraus. Zwar arbeitet DOS bei den 
Funktionen zur Speicherverwaltung immer mit der Seg- 
mentadresse des allokierten Bereichs, doch läßt sich die 
Segmentadresse des zugehörigen MCB leicht ermitteln, 
indem man einfach 1 von der Segmentadresse des Speicher- 
bereichs abzicht. 


[N Aufbau eines Memory-Control-Blocks (MCB) im Speicher gg 
hat] mar: 


+28h| ID 
("Z” = letzter MCB, "M” = es folgen weitere) 
Pan) Segmentadresse des zugehörigen PSP | 1 word | 


Anzahl der Paragraphen im allokierten Spei- 
cherbereich 


+85h| ungenutzt 
18h] der allokierte Speicherbereich 
Länge: 16 + die Größe des allokierten Speicherbereichs 


Abbildung 1: Aufbau eines MCB. 
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Wie die Abbildung 1 zeigt, enthält der MCB drei Felder. 
Im ersten Feld hat sich einer der Schöpfer von MS-DOS, 
der Amerikaner Mark Zbikowski, verewigt, indem es immer 
einen der beiden Buchstaben seiner Initialen enthält. "M" 
zeigt dabei an, daß auf diesen MCB noch weitere MCBs 
folgen, während "Z" darauf hindeutet, daß es sich hier um 
den letzten MCB im Speicher handelt. 

Im zweiten Feld ist die Segmentadresse des PSP des 
zugehörigen Programms verzeichnet. Sie ist nur dann von 
Bedeutung, wenn es sich bei dem allokierten Speicher- 
bereich um das Environment eines Programms handelt, auf 
dessen PSP dieses Feld dann zeigt und so eine Verknüpfung 
herstellt. Handelt es sich bei dem Speicherbereich hingegen 
um einen PSP, so zeigt dieses Feld in den meisten Fällen 
auf den Speicherbereich selbst. 

Bedeutend wichtiger ist demgegenüber das dritte Feld 
im MCB, das die Größe des zugehörigen Speicherbereichs 
in Paragraphen angibt. Da unmittelbar hinter dem Ende des 
allokierten Speicherbereichs der nächste MCB folgt (sofern 
das ID-Feld nicht "Z" enthält), enthält dieses Feld damit 
auch die Entfernung zum nächsten MCB minus 1. Da somit 
jeder MCB indirekt auch auf den folgenden MCB zeigt, 
ergibt sich dadurch eine verkettete Liste, mit deren Hilfe 
alle MCBs aufgespürt werden können. 

Wird ein Programm von dem EXEC-Loader des DOS 
geladen und zur Ausführung gebracht, werden von dieser 
Funktion zunächst zwei Datenbereiche über eine andere 
DOS-Funktion angefordert. Der erste dieser beiden Berei- 
che dient dabei zur Aufnahme des Environment-Block, 
während der zweite das eigentliche Programm und den 
dazugehörigen PSP aufnehmen soll. Gerade aber die Größe 
dieses Bereiches, d.h. die Größe des Speicherraums, der 
einem Programm zur Verfügung gestellt werden muß, ist 
für den EXEC-Loader nur sehr schwer abzuschätzen. 


Anfang des Speichers 
(0000:0000) 


Anfang der TPA 


von Memory Control Block kontroliert 


Memory Control Bloc 
von Memory Control Block 2 kontrolli 


von Memory Control Block 3 kontroliert 


Memo 'ontrol Block 4 (letzter Memory Control Blo 


von Memory Control Block 4 kontroliert 
Ende des AT 


Abbildung2: Die Verwaltung des Speichers mit Hilfe von 
Memory Control Blocks 


Dies fällt ihm bei COM-Programmen noch schwerer als 
bei EXE-Programmen, da sie auf Platte als Abbild des 
Speicherinhalts gespeichert sind und ihnen keinerlei 
Informationen vorausgehen. Aus diesem Grund nimmt 
DOS den Maximalfall an und belegt für ein COM- 
Programm den gesamten zur Verfügung stehenden 
Speicher. 

Diese Methode war zwar in den Anfangstagen des DOS 
recht effizient, bringt aber heute einige Probleme mit sich. 
Während sich nämlich in den ersten DOS-Versionen immer 
nur ein Programm im Speicher befinden konnte, ist es 
mittlerweile möglich und gebräuchlich, daß ein Programm 
ein anderes Programm in den Speicher lädt und zur Aus- 
führung bringt, bzw. daß bestimmte Programme im Spei- 
cher resident verankert werden. Dies ist aber nicht möglich, 
wenn, wie z.B. nach dem Laden eines COM-Programms, 
kein Speicher mehr zur Verfügung steht. Aus diesem Grund 
sollte ein COM-Programm nach seinem Start immer den 
Speicher, den es nicht benötigt, wieder freigeben. 

Ein COM-Programm kann allerdings nur dann geladen 
werden, wenn genügend Speicher frei ist, d.h. der freie Spei- 
cherplatz mindestens so groß wie das COM-Programm plus 
256 Bytes für den PSP und mindestens 2 Bytes für den Stack 
ist. Allerdings muß das COM-Programm dafür Sorge tra- 
gen, daß der ihm zur Verfügung gestellte Speicher auch 
ausreicht. Gerade unter den oben erwähnten Minimalbedin- 
gungen ist die fehlerfreie Abarbeitung sehr in Frage gestellt, 
da wohl kaum ein Programm mit nur 2 Bytes Stack aus- 
kommt. 

Ganz anders verhält es sich mit EXE-Programmen, 
denen auf der Platte eine ganze Reihe von Informationen 
vorangehen, die vom Linker ermittelt werden. Diesen Infor- 
mationen kann der EXEC-Loader entnehmen, wieviel Spei- 
cherraum für die Segmente Code, Daten und Stack reser- 
viert werden muß. Daneben enthält der Vorspann eines 
EXE-Programms weitere Informationen, die angeben, wie- 
viel zusätzlicher Speicher für das EXE-Programm bereitge- 
halten werden muß. Dabei wird jedoch nicht die genaue 
Anzahl der Bytes angegeben, sondern vielmehr eine Ober- 
und eine Untergrenze des weiterhin benötigten Speichers 
definiert. Nach Möglichkeit versucht der EXEC-Loader, die 
Obergrenze an Speicher zu reservieren. Ist dies nicht mög- 
lich, gibt er sich auch mit der Untergrenze zufrieden bzw. 
reserviert den Rest des verbleibenden Speichers. Kann 
jedoch auch die Untergrenze an Speicher nicht zugeteilt 
werden, wird der Ladevorgang abgebrochen und die Kon- 
trolle an das Programm zurückgegeben, das den EXEC- 
Loader aufgerufen hatte (in den meisten Fällen ist dies der 
Kommandoprozessor). 

Gleiches geschieht nach der Ausführung des Pro- 
gramms, wobei jedoch zuvor der EXEC-Loader, wenn nicht 
durch einen bestimmten Funktionsaufruf durch das ausge- 
führte Programm (Funktion 31H des Interrupts 21H) ver- 


hindert, den reservierten Speicherbereich zur weiteren 
Verwendung wieder freigibt. 

Nachdem wir uns den theoretischen Hintergrund erar- 
beitet haben, wollen wir uns nun die Funktionen des DOS 
im Speichermanagement anschauen. Es sind dies im einzel- 
nen die Funktionen 48h, 49h und 4Ah, die über den Inter- 
rupt 21h aufgerufen werden, wobei jeweils die Funktions- 
nummer im AH-Register übergeben wird. 

Funktion 48h dient dabei zur Reservierung von Spei- 
cherplatz. Ihr wird neben der Funktionsnummer im AH- 
Register die Anzahl des reservierenden Paragraphen (je- 
weils 16 Bytes) im BX-Register übermittelt. Konnte die 
angeforderte Anzahl an Paragraphen reserviert werden, 
kehrt die Funktion mit einem gelöschten Carry-Flag zurück. 
Das AX-Register gibt dann die Segmentadresse des reser- 
vierten Speichers an. Er beginnt somit an der Adresse 
AX:0000. (Einen Paragraph davor befindet sich der zugehö- 
rige MCB.) Konnte jedoch nicht soviel Speicher wie 
gewünscht zur Verfügung gestellt werden, ist das Carry-Flag 
nach dem Funktionsaufruf gesetzt. Das AX-Register enthält 
dann einen Fehlercode und das BX-Register die Größe des 
maximal noch verfügbaren Speichers in Paragraphen. 

Da das DOS keine Funktion zur Verfügung stellt, mit 
deren Hilfe die Größe des noch nicht allokierten Speichers 
ermittelt werden kann, wird diese Funktion von Program- 
men oft in diesem Sinne mißbraucht. Indem vor ihrem Auf- 
ruf der Wert OFFFFh in das BX-Register geladen wird, wird 
ein Speicherbereich mit der Größe von 1 MByte angefor- 
dert, den das DOS natürlich nicht allokieren kann. Dadurch 
aber liefert die Funktion automatisch im BX-Register die 
Anzahl der noch nicht allokierten Paragraphen zurück. 

Das Gegenstück zu der Funktion 48h stellt die Funktion 
49h dar, mit der durch die Funktion 48h reservierter 
Speicherbereich wieder freigegeben werden kann. Ihr wird 
deshalb im ES-Register die Segmentadresse des freizuge- 
benden Speicherbereichs übergeben, die zuvor beim Aufruf 
der Funktion 48h im AX-Register erhalten worden war. 
Normalerweise sollte die Funktion 49h fehlerfrei ausgeführt 
werden können und dadurch das Carry-Flag nach dem 
Funktionsaufruf gelöscht sein. Ist dem jedoch nicht so, kann 
das zum einen daran liegen, daß der MCB des Speicher- 
bereichs (durch ein Programm) zerstört worden ist, oder 
daß die im ES-Register übergebene Segmentadresse nicht 
zu einem reservierten Speicherbereich gehört. 

Die dritte Funktion im Bunde dient dazu, einen bereits 
reservierten Speicherbereich in seiner Größe zu verändern. 
Es ist sowohl eine Vergrößerung als auch eine Verkleine- 
rung möglich. Man übergibt beim Aufruf der Funktion 4Ah 
im ES-Register die Segmentadresse des in seiner Größe zu 
modifizierenden Speicherbereichs und im BX-Register die 
Anzahl der Paragraphen, die der Speicherbereich umfassen 
soll. Die Registerbelegung nach dem Funktionsaufruf ist 
mit der von Funktion 48h identisch. 
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Programm-Beispiel 


Da sich der Aufruf der DOS-Funktionen zur Speicherver- 
waltung relativ einfach gestaltet und es dazu keiner beson- 
deren Tricks bedarf, widmet sich das folgende Beispielpro- 
gramm einem anderen Thema, daß jedoch nicht minder eng 
mit der Speicherverwaltung des DOS zusammenhängt. Die 
Rede ist von einem Programm, das im System herumspio- 
niert und ihnen alle allokierten Speicherbereiche sowie 
deren Inhalt anzeigt. Das Programm ist dabei intelligent 
genug, zwischen Speicherbereichen zu unterscheiden, die 
das Environment eines Programms, einen PSP oder andere 
Informationen enthalten. 

Aufgabe dieses Programms ist es damit, sich von MCB 
zu MCB durch den Speicher zu "hangeln", und die allokier- 
ten Speicherbereiche zu untersuchen. Um zum jeweils näch- 
sten MCB zu gelangen, bedient es sich dabei des dritten 
Felds innerhalb eines MCB, mit dessen Hilfe es einen Poin- 
ter auf den nächsten MCB erstellt. Es entsteht dadurch eine 
Schleife, die so lange durchlaufen wird, bis der letzte MCB 
entdeckt wird, dessen ID-Feld den Buchstaben "Z" enthält. 

Um sich aber durch die Kette der MCBs zu bewegen, 
muß zunächst die Adresse der ersten Glieds der Kette, also 
des ersten MCB ermittelt werden. Sie verzeichnet DOS 
innerhalb einer internen Struktur, die den Namen DIB 
(DOS Information Block) trägt und für Anwendungspro- 
gramme normalerweise nicht zugänglich ist, also ein undo- 
kumentiertes DOS-Feature darstellt. Die Adresse dieser 
Struktur kann jedoch mit Hilfe der Funktion 52h ermittelt 
werden, die diese nach ihrem Aufruf im Registerpaar 
ES:BX zurückgibt. 

Kurioserweise zeigt die übergebene Adresse jedoch 
nicht auf das erste Feld innerhalb des DIB, sondern bereits 
auf das zweite. Da aber gerade das erste Feld die für uns 
wichtige Adresse des ersten MCB enthält, befindet sich die 
gesuchte Information hinter dem übergebenen Pointer. Da 
der Pointer auf den ersten MCB aus einer Offset- und Seg- 
mentadresse besteht, ist er 4 Bytes lang und dadurch an der 
Adresse ES:(BX-4) zu finden. Diese Adressangabe ist 
jedoch mit großer Vorsicht zu genießen, da sie den 
Anschein erweckt, man müßte lediglich den Wert 4 vom 
Inhalt des BX-Registers abziehen, um im Registerpaar 
ES:BX die effektive Adresse der gewünschten Information 
zu erhalten. Dies führt nur dann zum Erfolg, wenn die Off- 
setadresse im BX-Register größer oder gleich 4 ist. Ist sie 
jedoch kleiner, hat diese Vorgehensweise verherende Fol- 
gen, da sich dadurch als Ergebnis eine negative Zahl ergibt. 
Die jedoch gibt es bei der Speicheradressierung nicht. Um 
dies an einem Beispiel deutlich zu machen: 

Wird im BX-Register als Offsetadresse des DIB der 
Wert 0 zurückgeliefert, ergibt sich durch die Subtraktion 
von 4 der Wert OFFFCh. Dieser wird zwar bei arith- 
metischen Operationen ganz richtig als -4 interpretiert, 
zeigt bei Speicherzugriffen jedoch nicht auf die Adresse -4, 
sondern eben auf OFFFCh und damit nicht vor, sondern 
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ganz an das Ende des zugehörigen Segments. Klar, daß man 
hier die benötigte Information nicht findet. 

Abhilfe schafft das Programm hier, indem es zunächst 
die übergebene Segmentadresse um 1 dekrementiert. 
Dadurch wird die effektive Adresse, die sich aus der Ver- 
knüpfung von Segment- und Offsetadresse ergibt, um den 
Wert 16 reduziert. Addiert man anschließend auf die Off- 
setadresse den Wert 12, reduziert sich die effektive Adresse 
gegenüber dem ursprünglichen Wert nur noch um 4 und 
zeigt dadurch auf die gewünschte Speicherstelle. Ohne Pro- 
bleme kann dieser Speicherstelle dann die Adresse des 
ersten MCB entnommen werden. 

Mit dieser Adresse beginnt die Schleife, in deren Ver- 
lauf alle MCBs durchlaufen und ausgewertet werden. 
Zunächst werden dabei einige Statusinformationen über 
den MCB und den von ihm verwalteten Speicherbereich 
ausgegeben. Dazu zählen 
= die Nummer des MCB 
= seine Adresse im Speicher 
= die Adresse des vom MCB verwalteten Speicherbereichs 
= der Inhalt des ID-Feldes ("M" oder "Z") 

m die Adresse des zugehörigen PSP (unabhängig davon, ob 
dieser überhaupt existiert) 

= die Größe des zugehörigen Speicherbereichs in Para- 
graphen und Bytes 

Daraufhin wird der Inhalt des zugehörigen Speicherbe- 
reichs untersucht, dessen Adresse durch die Inkrementie- 
rung der Segmentadresse des MCB um den Wert 1 ermit- 
telt wird. Zunächst wird dabei festgestellt, ob es sich bei 
dem Speicherbereich um einen Environment-Block handelt. 
Dies kann dann als sicher gelten, wenn sich am Anfang des 
Speicherbereichs der String COMSPEC= befindet, der 
jeden Environment-Block einleitet. Wird dieser String ent- 
deckt, geht das Programm davon aus, daß es sich hier tat- 
sächlich um einen Environment-Block handelt und gibt die 
einzelnen Environment-Strings aus. Diesen voran stellt es 
den Namen des Programms, zu dem der Environment- 
Block gehört, der sich ab der DOS-Version 3.0 am Ende 
des Environment-Blocks befindet. 

Kann der Speicherbereich nicht als Environment-Block 
identifiziert werden, handelt es sich möglicherweise um 
einen PSP und damit um ein transientes oder residentes 
Programm. Davon geht das Programm dann aus, wenn sich 
in den ersten beiden Speicherstellen des Speicherbereichs 
der Maschinensprache-Befehl INT 20h (Code OCDh, 020h) 
befindet, der jeden PSP einleitet. Trifft auch das nicht zu, 
kann nicht festgestellt werden, ob der Speicherbereich 
Programmcode, Daten oder was auch immer enthält. Um 
Ihnen hier die Möglichkeit zu bieten, sich ein eigenes Bild 
zu machen, gibt das Programm in diesem Fall die ersten 80 
Bytes des Speicherbereichs als Hex- und ASCII-Dump auf 
dem Bildschirm aus. Nachdem der Anwender der Aufforde- 
rung, eine Taste zu betätigen, nachgekommen ist, wird dann 
der nächste MCB untersucht und das Programm schließlich 
beendet, nachdem der letzte MCB bearbeitet wurde. 


MEMC (c) 1988 by Michael Tischer 


! 
= nicht Ydantı er ee) ar Daten) 
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Abbildung 3: Die Ausgabe des Programms MEMC.C 
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Abbildung 3: (Ende) 
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: Verfolgt die Kette der über DOS allokierten 
Speicherblöcke. 


: MICHAEL TISCHER 
entwickelt am : 23.08.1988 
letztes Update : 23.08.1988 


Erstellung 
Aufruf 


/"== Include-Dateien einbinden ==#u»unuuuunnnuunuunnnnnnunnunnnnnnunnnt/ 


#include <dos.h> 
#include <stdlib.h> 


run Beehet PPPPEERPEEEFRERREPPLELELLLLEN nununonunnnnse®/ 


/* wir basteln uns ein Byte */ 
I" eine Segmentadresse */ 


I" FAR-Pointer auf ein Byte */ 


{*n= Konstanten »nuenunnnunnnnnnnnnuuunnnnannunsnnnnnnnuunnunnununnnne"/ 


Idefine TRUE 1 /* werden zur Arbeit mit BOOLEAN benötigt */ 
#define FALSE 0 


/*== Strukturen und Unions ==uuuumuunuunnnuussonnnununnunnnnnnnnnnnent/ 


struct MOB ( /* beschreibt einen MCB im Speicher */ 
id_code; %, n = es folgt ein Block, 'Z' = Ende */ 


psp; * Segmentadresse des zugehörigen PSP */ 
unsigned abstand; r Anzahl der reservierten Paragraphen */ 


typedef struct MB far "MBPtr; /* FAR Pointer auf einen MCB */ 


frau Makros senwunnuunnunsunnnunnnnnunnsenunnnennnnnnennnunnnnnunnnnn/ 


Hifndef MK_F /* wurde MK_FP noch nicht definiert? */ 
ne MK ea, ofs) ((void far *) ((unsigned long) (seg)<<16/(ofs))) 
i 


Pboeiehehuleieheieielelebebelehulslebeheleheletchealehelchelsishleiehdiehsieishsheiehsteishehsdeiehueichehslshsiciehsteiehsichehsteieheied 


* Funktion :FIRSTY_NMCB 
.. 


: Liefert einen Pointer auf den ersten MB. 
” Eingabe-Parameter: keine 
* Return-Wert : Pointer auf den ersten MCB 


ee / 


MBPtr first_uch() 


union REGS regs; /* nimmt die Prozessorregister auf */ 
struct SREGS sregs; /* nimt die Segmentregister auf */ 


regs.h.ah = 0x52; /" Fkt.nr.: Adresse des DOS-Info-Block holen */ 
intdosx( Aregs, Aregs, sregs ); /* 00S-Interrupt Ox21 aufrufen */ 


I*-- ES:(BX-4) zeigt auf den ersten MB, Pointer erstellen 
yon "((McBPtr far *) NK_FP( sregs.es-1, regs.x.bx+l2 )) ); 


nd Gibt Hex- und ASCII-Dump eines Speicherbereiches * e 
B aus. 

* Eingabe-Parameter: - bptr : Pointer auf den Speicherbereich ? 
” - anz : Anzahl der Dumpzeilen (je 16 Byte) ® 
" ” 


Return-Wert : keiner 
een / 


void dump( FB bptr, byte anz) 


FB Iptr; il a zur Ausgabe einer Dump-Zeile */ 
unsigned offset; " Offsetadresse relativ zu BPIR */ 
byte i; /* Schleifenzähler */ 


printf("\nDUMP | 0123456789ABCDEF 00 01 02 03 04 05 06 07 08"); 
printf(” 09 0A OB 0C 00 DE OF\n*); 

printf(* + Ay; 
print — Ir); 


for (offset=0; anz-- ; offset += 16, bptr += 16) 
/* die Schleife ANZ mal durchlaufen */ 
printf("s04x | *, offset); 
for (Iptr=bptr, i=16; i-- ; Fer) /* Zeichen als ASCII ausgeben */ 
printf(*kc*, (u tr&32) BI WRRE) 5 


printf(* 
/* Zeichen als Hex ausgeben */ 


for (Iptr=bptr, i=16; | 
printf(*402X *, *Iptr++); 
PIEREIN: \n*); /* in die nächste Zeile schalten */ 


Listing 1: MEMC.C 
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Buchauszug 


os beiehdiebehuhieiehuh tabelle heteinhheteinhasinhhahehehehe iebehehla hehe keieheehehehe hehe ba hehedebehehehehehe 


:TRACE_NMCB 


" Aufgabe 
* Eingabe-Parameter: 
” Return-Wert 


tee / 


void trace ucb() 


static char fenv[] = { /* erster Environment- -String */ 
et, , te 


MCBPtr akt_wcb; /* Pointer auf den jeweils aktuellen MB */ 
boolean ende; /* wird TRUE, wenn der letzte MCB gefunden ist */ 
byte “ _ uch, /* Nummer des aktuell bearbeiteten MOB */ 
/* Schleifenvariable */ 
FB I /* laufzeiger in das Environment 


ende = FALSE; /" jetzt geht's erst mal los 
ar_mcb » 1; /* der erste MB trägt die Nummer 1 
akt uch = first _uch(); /* Pointer auf den ersten MCB holen 
do /" die einzelnen MBs abarbeiten 


{ 

if ( akt_mcb->id_code == 'Z' ) /* letzten MCB erreicht? */ 

ende = TRUE; I" Ja */ 
printf{"MB-Nummer = kd\n*, nr. De: 

printf{"MB-Adresse = kfp\n*, akt_mc 

printf{*Speicher-Adr. = :0000\n” , r Ses(akt sch)el); 

printf("ID = kc\n*, akt mcb->id 

printf("PSP-Adresse = kfp\n*, IHES ie wcb-> 2 0) ); 
printf(*Größe 1 Paragrap *lu Bytes 

akt meh->abstand. "Fol | akt_mch->a stand << 4); 

printf(*Inhalt 


/*=-- handelt es sich um ein Environment? -- 
for (i=0, Iptr=(FB)akt_wcb+16; /* ersten ENY-String mit FENV vergl. 
( i<sizeof fenv ) 88 ( »(Iptr+t) =» fenv[it] );) 


/* wurde der String entdeckt? 
/* Ja, es handelt sich um ein Environment 
printf(*Environment\n"); 
if ( _osmajor >= 3) /" 005-Version 3.0 oder höher? 
/* Ja, Programmnamen ermitteln 


if ( i == sizeof fenv ) 


printf(* ar 
for 0; Veliserseje [1 pero) ; i) 
etzten ENY-String suchen 


if ( "Ülptr += 3) ) I" Bafinder sich hier ein a 
a 

for (; /* den Programmnamen durchlaufen 

N rin. er 5 aha) ); /" jeweils ein Zeichen ausgeben 


else /* es wurde kein Programmname entdeckt 
printf("unbekannt*); 
N ai Sa /" in die nächste Zeile schalten 


/*-- die Environsent-Strings ausgeben 
printf("Environment-Strings\n*); 
for (Iptr=(fB) akt_wcb +16; *Iptr ; ++1ptr) 
/* einen String ausgeben 
printf(* 


*); 
for ( ; *Iptr ; ) /* den String bis zum WL-Zeichen durchlaufen 
printf( *%c*, *(Iptr++) ): /* jeweils ein Zeichen ausgeben 
jenen \n*); /* in die nächste Zeile schalten 


else /* kein Envrionment 


- handelt es sich um einen 
je. wird durch Befehl INT 20 0 (Codanoxc RE 
if (t a far WA FP( akt_mch->ps ) == 0x20cd) 
Ar ("psp nachfol Bea I" Ja */ 
* der Befehl INT 0x20 konnte Mar entdeckt Pe “/ 


rin nicht identifizierbar (Programm oder Daten)\n 
ad F 


) 


printffmk—————— ne), 

printf(* Bitte Taste drücken ——\n"); 

if ( !ende ) /* folgt noch ein MB ? */ 
/* Ja, Pointer auf den nächsten MB setzen */ 


akt uch =» en ) 
MK_FP( FP_SEG(akt_mcb) + akt_meb->abstand + 1, 0 ); 
getch(); /* auf eine Taste warten */ 


) 
uanden ( tende ); /* wiederholen, bis der letzte MCB bearbeitet ist */ 


[eemumnennentnn nn nenn nenne / 


I HAUPTPROGRAMM ER 


ee) 


void main() 


printf(* Kg (<) 1988 by Michael Tischer\n\n"); 
ler mcb(); /* die Kette der MCB nachverfolgen */ 


Listing 1: (Ende) 


B) akt_uch + 16, 5); /* die ersten Mei Bytes dumpen */ 


Buchauszug 


Um Ihnen eine Interpretationshilfe bei der Auswertung 
der Ausgaben des Programms zu geben, zeigt die Abbildung 
3 die Ausgaben des Programms, nachdem es auf dem Rech- 
ner des Autors gestartet wurde. In den folgenden Absätzen 
wird die Bedeutung der einzelnen Speicherbereiche be- 
schrieben. 


1 Der erste MCB kann zwar vom Programm nicht identifi- 
ziert werden (die angegebene PSP-Adresse besitzt daher 
keinerlei Informationswert), doch läßt der beigefügte 
Speicherauszug seinen Inhalt erahnen. In der ersten 
Zeile des ASCII-Dump findet sich das Wort $CLOCK, 
der Name, mit dem DOS den Gerätetreiber für die 
interne Uhr bezeichnet. Und tatsächlich scheint es sich 
hier um den Speicher für einen Gerätetreiber zu han- 
deln, denn der Aufbau der ersten 18 Byte entspricht 
genau dem Aufbau des Kopfes eines solchen Geräte- 
Treibers. Dabei kann es sich jedoch nicht um einen der 
fest installierten Geräte-Treiber des DOS handeln, da 
sie unterhalb der TPA (Transient Program Area) instal- 
liert werden und für sie deshalb kein Speicher allokiert 
werden muß. Darum muß es sich hier um einen Geräte- 
Treiber handeln, der beim Booten des Systems über den 
DEVICE-Befehl innerhalb der Konfigurationsdatei 
CONFIG.SYS installiert wird. Tatsächlich habe ich dort 
als ersten Geräte-Treiber den Treiber AT-UHR.SYS 
aufgeführt, der als Geräte-Namen den Namen $CLOCK 
trägt. Um diesen Treiber muß es sich hier also handeln. 
Da dieser Treiber jedoch nur wenige KByte groß ist, der 
allokierte Speicherbereich darüber jedoch weit hinaus 
geht, muß sich hinter dem Treiber noch anderer Pro- 
grammcode oder Daten befinden. Ein Blick über die 5 
Zeilen des Dump, wie sie das Programm ausgibt, hinaus 
zeigt, daß dahinter auch alle anderen Treiber folgen, die 
ich über den DEVICE-Befehl eingebunden habe. Der 
erste allokierte Speicherbereich wird vom DOS also 
bereits während des Bootvorgangs allokiert, um die ein- 
zubindenden Geräte-Treiber in der Reihenfolge ihrer 
Nennung innerhalb der Konfigurationsdatei aufzuneh- 
men. 

2 In diesem Speicherbereich befindet sich offensichtlich 
ein Programm. Da ihm jedoch kein PSP vorangeht, der 
seinen Namen verraten könnte, bleibt der Name des 
Programms unbekannt. An seiner Lage innerhalb der 
MCB-Kette und innerhalb des Speichers kann man 
jedoch feststellen, daß es bereits kurz nach dem Boot- 
vorgang in den Speicher gebracht und dort resident 
installiert wurde. 

3 Über den Inhalt dieses Speicherbereichs kann keine 
Aussage getroffen werden. Entweder ist er von einem 
Programm allokiert worden, um später Daten darin 
abzulegen, oder er ist einfach bei der Freigabe von Spei- 
cher "übrig geblieben". 

4 Ganz offensichtlich handelt es sich hier um ein Envi- 
ronment, dem jedoch der zugehörige Programmname 


fehlt. Als Adresse des PSP wird die Adresse OFDC:0000 
angegeben, an der sich der Speicherbereich befindet, der 
über den MCB 2 allokiert wurde. Da es sich bei MCB 2 
um einen PSP und bei MCB 4 um ein Environment han- 
delt, liegt die Vermutung nahe, daß es sich hier um ein 
Programm und dessen zugehöriges Environment han- 
delt. Da der Environment-Block keinen Programm- 
namen enthält, kann davon ausgegangen werden, daß 
das Programm im MCB 2 weder über die Benutzerober- 
fläche des DOS noch durch einen Befehl innerhalb einer 
BATCH-Datei eingeladen und gestartet wurde. Viel- 
mehr scheint es sich beim MCB 2 um den residenten 
Teil des Kommandprozessors COMMAND.COM zu 
handeln, der sein Environment im MCB 4 abgelegt hat. 
Untersucht man den Programmcode im MCB 2 mit 
Hilfe eines Debuggers bestätigt sich diese Vermutung. 
Hier befindet sich das Environment des Programms 
KEYB.COM, das die Arbeit mit der deutschen Tastatur 
erlaubt und innerhalb meiner AUTOEXEC.BAT durch 
den Befehl KEYB GR gestartet wird. Da es sich noch 
immer im Speicher befindet, handelt es sich bei ihm um 
ein residentes Programm, das nach seiner Installation im 
Speicher verbleibt. 

Während sich das Environment des Programms KEYB. 
COM im MCB 5 befindet, haben wir hier den Speicher 
für dieses Programm (also PSP, Programmcode und 
Daten) vor uns. Erkennbar wird dies bereits daran, daß 
die PSP-Adresse im Environment-Block (MCB 5) auf 
den Speicherbereich zeigt, der durch diesen MCB ver- 
waltet wird. 


7, 8 Diese beiden Speicherbereiche nehmen das Environ- 


ment und den PSP (bzw. den Programmcode) des Pro- 
gramms CED.COM auf, das ich innerhalb der AUTO- 
EXEC.BAT aufrufe. Da es sich noch immer im Speicher 
befindet, handelt es sich bei ihm offensichtlich um ein 
residentes Programm. 


9, 10 Wie 7 und 8, jedoch für CACHE-AT.COM. 
11, 12 Auch hier handelt es sich um die Speicherbereiche 


eines Programms und seines Environments. Zwar ist das 
Environment eindeutig zu erkennen, doch konnte der 
PSP nicht erkannt werden. Dies liegt daran, daß dieses 
Programm seinen PSP als Tastaturpuffer mißbraucht 
und daher der Interrupt-Aufruf am Anfang des PSP 
überschrieben wird. Da dieser Befehl als PSP-Kennung 
dient, kann dieser Speicherbereich nicht mehr als PSP 
erkannt werden. 


13 Zwar meldet das Programm, daß es sich hier um einen 


PSP handelt, doch kann es sich hier lediglich um den 
Anfang eines PSP handeln, da der Speicherbereich nur 
64 Byte groß ist, ein PSP aber 256 Byte benötigt. Wahr- 
scheinlich befand sich an dieser Stelle einmal ein PSP, 
der aber nicht komplett wieder freigegeben wurde, so 
daß sich ein Rest immer noch im Speicher befindet. 


14, 15 Da das Programm zur Ausgabe der MCBs und ihrer 


Inhalte in C verfaßt wurde, befand ich mich innerhalb 
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der QuickC-Umgebung als ich das 
Programm startete, um den Spei- 
cherauszug zu erstellen, von dem 
ich gerade spreche. In den MCBs 
14 und 15 findet sich deshalb das 
Environment und der Programm- 
code des QuickC-Programms. 

16, 17 Um einen MCB- bzw. Speicher- 
dump zu erhalten, habe ich das 
Programm MEMDEMO innerhalb 
von QuickC zur Ausführung ge- 
bracht. Die Ausführung des Pro- 
gramms hat QuickC dadurch 
gestartet, daß es das Programm mit 
Hilfe des EXEC-Loaders als Toch- 
ter-Prozeß aufgerufen hat. Die 
Speicherbereiche 16 und 17 sind 
daher vom EXEC-Loader allokiert 
worden, um das Programm auszu- 
führen. Nach Programm-Beendi- 
gung dürften sie wieder freigege- 
ben worden sein. 

18 Der letzte Speicherblock umfaßt 
den Rest des Speichers, der noch 
nicht allokiert wurde. In diesem 
konkreten Fall sind das knapp 200 
KByte. 

Das C-Beispielprogramm in Listing 

1 gibt einen MCB-Dump aus, wie er in 

Abbildung 1 gezeigt wurde. 


DIE NEUEN MICROSOFT 


COMPILER FÜR 
MS-DOS UND MS-0S/2. 


Start frei für Höhenflüge. Die neuen leistungsfähi- 
gen Compiler von MICROSOFT erlauben Ihnen die 


Das Programm arbeitet zum Zu- 
griff auf den Speicher mit FAR- 
Pointern, da sich die zu adressieren- 


Entwicklung professioneller Applika- 


den Speicherbereiche außerhalb seines 
Datensegments befinden. Daß die 


tionen für MS-DOS und MS-05/2 - Programmgröße Pointer vom Typ FAR sind, wird 
mit ihnen können unter MS-DOS ent- elute, innerhalb von C durch die Wahl eines 
wickelte Programme problemlos auf Imterprozeß- ee u Fe een 
; : Kommunikation mpact, Huge oder Large er mit 
MS:05/ . PORN, werden. Dann ” Gemischt-sprachli- Hilfe von Cast-Operatoren erreicht, 
sind mit allen dafür notwendigen Pro- ches Poesie: die jeweils explizit die Arbeit mit 
grammierwerkzeugen ausgestattet: Dynemisch En einem FAR-Pointer definieren. Der 
dem konfigurierbaren und program- Bibliotheken und Idee Weg wurde he Sicacın Krer 
Programme gramm beschritten, um auch die Kom- 
mierbaren MICROSOFT EDITOR, dem WINDOWS- und pilierung unter einem Speichermodell 
derzeit effizientesten Debugger für die rue zu erlauben, das standardmäßig mit 
Fehlersuche, MICROSOFT CODEVIEW mierung mit ae arbeitet (Small und 
MICROSOFT C, SARIBR; 
— mit LIB, LINK, MAKE, BIND usw... yasm und pascAL Ein Problem stellt die Umwand- 
Aber das ist noch lange nicht alles - = Neue Version des lung einer getrennt ermittelten Offset- 
das Familen-Konzept bringt Sie noch vers, nut e. eg I FAR- 
M e Ep young z 2 ointer dar. In ann dies mit einem 
einen Schritt weiter in Richtung profes- 7 lien £ Ekkess zmalisiere enden: Kikeee diese 
sioneller Programmentwicklung. Alle Programme kurzen Anmerkungen hinaus sollte das 
neuen MICROSOFT COMPILER ent- Maag ws Listing für sich sprechen können, da es 
. u misch gelinkte er re 
halten dieselben Tools. Damit ist es Module an _ Tischer 
jetzt möglich, gemischt-sprachliche " Kenfigurierbarer 
A und programmier- 
Programme unter einer einheitlichen barer Makro-Editor 
Inkremental-Linker, 


Entwicklungsumgebung zu erstellen: 
von MICROSOFT € 5.1. über MASM 
51. FORTRAN 41. BASIC 6.0, 
COBOL 3.0 bis PASCAL 4.0. Und zwar 
unter MS-DOS und MS-0S/2! 


Binder, MAKE-Utili- 
ties u.v.a. 

Alle Tools jeweils 
für MS-0S/2 und 
für MS-DOS 


Haben Sie noch Fragen? Dann fragen Sie uns. 
Denn wir haben heute schon die Antwort für 
morgen parat. 


ms/nes] (ms/os/2) [me] Bi 2154 


Microsoft 


ZUKUNFT DER SOFTWARE 


couUuPpPOoN 


Bitte senden Sie mir Informationsmaterial zu: U] MICROSOFT COMPILERN. 
U] System Journal, die spezialisierte PC-Fachzeitschrift für Software-Entwicklung 

Ich nutze Software: [U] privat U] beruflich/ Branche 

Mein Rechner: D MS-D0OS DI MS-05/2 UI Maeintosh 

Bitte senden Sie den Coupon an: Microsoft GmbH - Erdinger Landstraße 2 - 


Absender nicht vergessen. 


B011 Aschheim-Dornach 


DOS und OS/2 


2-Programme unter DOS: 


Presentation Manager-Bibliothek für DOS 


Mit dem Entwicklungstool QuickStep Presenta- 
tion Manager stellt Lauer & Wallwitz einen zum 
OS/2 Presentation Manager von Microsoft 
kompatiblen Window-Manager zur Anwendung 
unter DOS und UNIX vor. Der QuickStep Pre- 
sentation Manager arbeitet vollständig im 
Textmodus und schließt die Lücke zwischen 
DOS und OS/2. Rainer Wallwitz beschreibt hier 
die Ideen und Konzepte, die hinter dem 
QuickStep Presentation Manager stehen. 


Die Idee 


Den ersten Kontakt zu MS-Windows hatten wir 1986/87 
anläßlich der Entwicklung zweier neuer Applikationen. 
Obwohl die Entscheidung, Windows als Benutzeroberfläche 
einzusetzen, zum damaligen Zeitpunkt sicher exotisch 
genannt werden kann - es gab noch keine Tools und fast 
keine Informationen - erschien sie uns in Hinblick auf die 
Absicht Microsofts, auch OS/2 mit einer grafischen Ober- 
fläche zu versehen, als sinnvoll. Nun, zwei Jahre später, ist 
diese grafische Oberfläche, der OS/2 Presentation Manager 
für OS/2 und Windows in der Version 2.x für DOS, verfüg- 
bar. So weit so gut. Vollkommen zufriedenstellend ist die 
Situation jedoch leider noch nicht, wie wir bei unseren 
ersten Gehversuchen mit dem Presentation Manager SDK 
feststellen mußten. Der Presentation Manager stellt eine 
erhebliche Weiterentwicklung und Verbesserung des Win- 
dows-Konzeptes auf Kosten der Kompatibilität zwischen 
beiden dar. 

Obwohl diese Weiterentwicklung zu begrüßen war, 
standen wir als Entwickler von MS-Windows-Applikationen 
vor dem Problem, daß einerseits unser Quellcode aufgrund 
der Inkompatibilitäten zwischen Windows und dem Presen- 
tation Manager nur mit erheblichem Aufwand nach OS/2 
zu portieren ist und andererseits nach einer erfolgten 
Portierung zwei Versionen der Programme existieren wür- 
den, die getrennt gewartet und weiterentwickelt werden 
müßten. Hinzu kommt, daß wir der Grenze an freiem Spei- 
cherplatz immer näher kamen und das unsere Applikatio- 
nen bzw. MS-Windows eine gute grafische Hardware vor- 
aussetzen. Dies mag unter DOS nur eingeschränkt gelten, 
für UNIX jedoch, wo die Mehrzahl der Arbeitsplätze mit 
ASCII-Terminals ausgestattet ist, sind Windows- oder Pre- 
sentation Manager-Anwendungen überhaupt nicht einsetz- 
bar. 

Die Lösung war offensichtlich: Man braucht zusätzlich 
zu der grafischen Oberfläche Microsofts unter OS/2 und 
UNIX (zur Zeit in Entwicklung) eine Oberfläche unter 
DOS, die im Textmodus arbeitet, weitestgehgend kompati- 
bel zum OS/2 Presentation Manager ist und die unter DOS 
nicht mehr als 100 KByte Speicherplatz benötigt. Die Ober- 
fläche sollte sich dabei in einer Bibliothek befinden, deren 
Funktionen nach Bedarf mit denen der Applikation zusam- 
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Abbildung 1: So sieht ein mit dem QuickStep Presentation 
Manager geschriebenes Programm unter DOS aus. 


mengelinkt werden können. Im Fall der Verfügbarkeit von 
ausreichend guter Grafik-Hardware unter OS/2 und UNIX 
linkt man mit den Bibliotheken von Microsoft, ansonsten, 
vor allem unter DOS, mit den QuickStep-Bibliotheken. Auf 
diese Weise erreicht man einen hohen Grad an Portabilität 
zwischen den Betriebssystemen DOS, OS/2 und UNIX und 
kann vor allem mit der zur Zeit vorhandenen Hardware 
(640 KByte, Real-Mode) und seinen individuellen Entwick- 
lungstools Applikationen für den Presentation Manager 
unter DOS entwickeln. 

Im Laufe des Jahres 1987 beschlossen wir das Projekt 
Presentation Manager/DOS anzugehen und eine entspre- 
chende Bibliothek zu entwickeln, die auf der CeBIT 89 vor- 
gestellt werden sollte. Wir liegen zwar recht gut in der Zeit, 
aber dennoch kann hier nur eine Vorversion beschrieben 
und vorgestellt werden, obwohl fast alle Features, von Dia- 
logboxen und Clipboardfunktionen abgesehen, implemen- 
tiert sind. Als Implementationssprache der DOS-Version 
wurde Microsoft-C (Version 5.1) in Kombination mit dem 
Microsoft Macro-Assembler Version 5.1 benutzt, wobei nur 
die Hardwaretreiber (Maus, Tastatur, Timer, Video) aus 
Platz- und Performancegründen in Assembler geschrieben 
sind. 

Die entwickelte Presentation Manager-Bibliothek für 
DOS ist ein Teil unserer QuickStep-Tools, einer Biblio- 
theksserie für Entwicklungen mit C, Pascal und Modula-2 
unter DOS, Windows, OS/2 und UNIX. Der QuickStep 
Presentation Manager (OS-PM) ist von seinem Funktions- 
umfang und »look & feel« im wesentlichen kompatibel zum 
Microsoft OS/2 Presentation Manager (OS/2-PM). Im 
Gegensatz zum OS/2-PM ist der QS-PM jedoch keine 
Betriebssystemerweiterung, sondern eine Bibliothek, die 
vom Programmierer in seine Applikation eingebunden wer- 
den muß, vergleichbar den Dynamic-Link-Bibliotheken von 
Microsoft. 


DOS und OS/2 


SRREEESENSEEEEEEEEREESENEERSENEEEREEETENEESSEREEETESEEREEESSERGEEnEnnEnnnnn 


Funktionsübersicht der 05/2 PM kompatiblen Funktionen 


Busgabe eines Strings . 

Einleitung der WM_PÄINT-Nachricht 
Erzeugung eines Windows 

Erzeugung eines Tastatur-Cursors 

Erzeugung der Syst: 

erg m eines Standard- bzw. Frame-Windows 
Zers des Tastatur-Cursors 
Default-Windowfunktion 

Zerstörung eines Windows 

Verteilen der Nachrichten 

Zerstörung der System-Queue 

Ende der WM_PAINT-Nachricht 

Rechteck füllen 

Message aus System-Queue lesen 
Tastaturstatus lesen 

Presentation Space holen 

Rechteck invalidieren 

Presentation Manager initialisieren 
Schnittrechteck berechnen 

String aus Ressouce laden 
Accelerator-Tabelle aus Ressource laden 
Menu aus Ressource 1a 

Message-Box darstellen 

Input-Focus erfragen 

Window-Handle mit QW_* erfragen 

Message in die System-Queue legen 

re eg System-Queue lesen 

Punkttest 2 

Rechteck des Windows erfragen 

aktive Window-Handle erfragen 

Position des Mauszeigers erfragen 

Text der Titelbar-Control eines Windows erfragen 
32-Bitwert aus lokalem Windowbereich lesen 
Mautzel gar in Rechteck einschließen 
Windowklasse registrieren 

Message versenden 

32-Bitwert in lokalen Windowbereich schreiben 
Text der Titelbar-Contro] eines Windows setzen 
Mauszeiger erz 

Focus-Window festlegen 

Rechteck definieren 

Mauszeiger positionieren 

Haus-Message abfangen 

aktives Window definieren 

Setzen der Windowposition 

Tastaturcursor darstellen bzw. verstecken 
Mauszeiger darstellen bzw. verstecken 
Window darstellen bzw. verstecken 


Vereinigung zweier Recheckflächen 
Window- le aus FID_*-Werten 
Window-Handle aus Positionsinformation 


optionale Konfiguration der Treiber 
liefert Zeiger auf String-Ressource 
aktuelle Zeichenfarbe von Window erfragen 
aktuelle Position des Viewports erfragen 
aktuelle Ausdehnung des Viewports erfragen 
aktuelle Position Windows erfragen 
aktuelle Ausdehnung des Windows erfragen 
aktuelle Zeichenfarbe des Windows setzen 
logische Position des 

logische Länge des 0 

logische Position des Vi rts setzen 
logische Länge des Viewports setzen 


“nnSnnEnnEunEEEEEEEEEEEEE EEE EEESEREEnSEnSEREEEEEETEEEEEEEEEEEnEnnnnun nn 


Tabelle 1: Funktionsübersicht der OS/2-PM-kompatiblen 
Funktionen 


Die Implementation 


Der OS-PM ist, analog dem OS/2-PM, Message- bzw. 
Event-Driven und verfügt über ein identisches Maus-, 
Timer- und Tastaturinterface. Des weiteren sind die mei- 
sten der Nachrichten wie Window- (WM _*), Scrollbar- 
(SBM_*), Titlebar- (TBM_*) und Menu- (MM_*) Nach- 
richten und Funktionen implementiert. Die Tabellen 1 bis 3 
zeigen die wichtigsten unterstützten Funktionen (Tabelle T), 
Datenstrukturen (Tabelle 2) und Nachrichten (Tabelle 3). 
Die größten Unterschiede bestehen naturgemäß in der Art 
der Textdarstellung. 


Datenstrukturen 


Positionsangabe (x,y) 
Rechteckdefinition 
Positionsangabe (x,y) 
Rechteckdefinition 
Nachrichtenstruktur 
Daten der Windowklasse 
enthält Informationen zur Kreierungszeit 
Information über das aktuelle Tracking-Rectangle 
Struktur eines Menueintrages 

Daten des Windows 

Informationen über die Windowklasse 


EuREnEnEunEERNEEEEEERENREREEEERSEERENEEEIREHESEEESEEEEEEEuE nn En nununnnnem 


16-Bit 
16-Bit 


32-Bit 
32-Bit 


Tabelle 2: Datenstrukturen 


Die im grafischen Modus (OS/2-PM) notwendigen 
Koordinatentransformationen vom Window- in das View- 
portkoordinatensystem gestalten sich im Textmodus ein- 
facher, da hier beide Koordinatensysteme die gleiche 
Skalierung besitzen und nur ihr Ursprung gegeneinander 
verschoben sein kann. Die mit der Textdarstellung ver- 
knüpfte Farbinformation wird im QS-PM als Attributbyte 
verwaltet, wohingegen im OS/2-PM eine 32-Bit-Größe zur 
Kodierung der verschiedenen Farbebenen benutzt wird. 
Vektorfonts wird der QS-PM-Programmierer gänzlich ver- 
missen, da sie im Textmodus nicht implementierbar sind. 
Raster- bzw. Bitmapfonts dagegen werden unterstützt, 
sofern die jeweilige Videohardware dies zuläßt. Die Abbil- 
dung 1 ist zum Beispiel an einem EGA-Bildschirm gemacht 
worden, bei dem ein Teil des Zeichensatzes durch die Funk- 
tionen des entsprechenden Videotreibers zur Angleichung 
an die grafische Variante des PMs umdefiniert wurde. 

Die Darstellungsgeschwindigkeit des QS-PM läßt nichts 
zu wünschen übrig, da der Videotreiber direkt auf den Bild- 
schirmspeicher zugreift. Der Platzbedarf des QS-PM- 
Kernels liegt etwa zwischen 60 - 80 KByte. Das aufgelistete 
Beispielprogramm DEMO.C (Listing I) besitzt als EXE- 
Datei eine Größe von ca. 91 Kbyte, wobei in diesem Pro- 
gramm der größte Teil der Laufzeitbibliothek und zahlrei- 
che String- und Menüdefinitionen enthalten sind. Ähnlich 
der Konvention unter MS-Windows und OS/2-PM, wird im 
QS-PM die Pascal-Aufrufsequenz und als Speichermodell 
das Large-Model benutzt, so daß alle Datenzeiger 32-Bit 
lang sind. Die Benutzung der Pascal-Aufrufsequenz hat 
zwei Vorteile: Erstens verkürzt sich der Codeumfang des 
Kernels um ca. 4 KByte und zweitens ist die Pascal-Cal- 
lingsequenz besser zur Integration von in Pascal, Modula-2 
und insbesondere von in Assembler geschriebenen Routi- 
nen geeignet. 

Die gesamte Textausgabe seitens des Entwicklers findet 
über die beiden Funktionen GpiCharStringAt() und Gpi- 
TextOutQS() statt, von denen die erste eine OS/2-PM- 
kompatible Funktion ist und auf die zweite zugreift. Die 
Darstellung findet immer in der aktuellen Farbe und in dem 
Window statt, dessen Presentation-Space Handle (hPS) 
beim Aufruf von GpiCharStringAt() übergeben wurde. Die 
Farbunterstützung unterscheidet sich jedoch etwas von der 
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DOS und O0S/2 


Nachrichten 


t 

i der Applikation 
Windowparameter setzen 
Windowparameter Srtrugen 
dient zum "flashing* des Rahmens 
dient zum Löschen des Windowhintergrungs 
beim Drücken einer Taste gesendet 
bei der Anwahl eines Menupunktes oder Accelerator 


analog WM_COMMAND 

analog WM_COMMAND 

Timertick-Notification 

schickt Control an Parent/Owner 

bei "fatalen” Fehlern gesendet 

vor Vergrößerungen/Verkleinerungen und Ikonisierungen 


bei der Bewegung der Maus 

beim Betätigen linken Mausknopfes 
WM BUTTONIUP beim Loslassen des linken Mausknopfes 
WATBUTTONIOBLCLK 1-Click des linken Mausknopfes 
WATBUTTON2DOWN beim Betätigen des rechten Mausknopfes 
WMTBUTTONZUP beim Loslassen des rechten Mausknopfes 
WMTBUTTONZDBLCLK pel-Click des rechten Mausknopfes 
WMTBUTTON3DOWN beim Betätigen des mittleren Mausknopfes 
beim Loslassen des mittleren Mausknopfes 


WM_BUTTONZUP 
WMTBUTTON3DBLCLK Doppel-Click des mittleren Mausknopfes 


vor der 


ung des "Tracking*-Rechtecks 
waren der 


WM_QUERYTRACKINFO 
TBA_TRACKMOVE ung des "Tracking"-Rechtecks 


TBM-SETSTATE 
TBM-QUERYSTÄTE 


vor der Darstellung eines Menus gesendet 
nach der Auswahl eines Menus t 


en 
D) des Menueintrags erfragen 
D erfra 


EMYALID 
MALQUERYITEMTEXTLENGTH 


beim Anklicken des horizontalen Scrollbars gesendet 
am Anklicken des vertikalen Scrollbars gesendet 


Position des "Sliders" setzen 


Position des "Sliders* erfragen 
Definitionsbereich des "Sliders" erfragen 


Tabelle 3: Die unterstützten Nachrichten 


des OS/2-PMs, da jedes Window einen lokalen »Farbraum« 
besitzen kann, der mit Hilfe eines weiteren Class-Styles 
CS_OWNCOLOR bei der Registrierung der Windowklasse 
erzeugt wird. Unterbleibt die Spezifikation CS_OWN- 
COLOR, benutzt das dieser Klasse zugeordnete Window 
den globalen Farbraum (default). Korrespondierend zur 
Deklaration eines eigenen Farbraumes je Window, erhalten 
die Windows bzw. Controls zu bestimmten Zeiten die 
Color-Notification-Message WM_COLOR. 
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Class-Styles Bedeutung Tab.4 
C$_SIZEREDRAW 
FY 


e Aktaa] sierung nach einer 6: veränderung (defauit 
CSMOVENOTI Notification-Message bei Veränderung der Windowposition (default 
CS_CLIPSIBLINGS 


Berücksichtigung anderer Child-Windows default 


CS_CLIPCHILDREN Berücksichtigung der eigenen Child-Windows (default 
CS_PARENTCLIP au 


default 
CS_SYNCPAINT Kefent eine unmittelbare Aktualisierung 
bewirkt ein "Frame-Flashing" bei der Aktivierung (nur QS-PH) 
Erzeugung eines sigenen Farbraumes (nur QS-PM i ‚ 
Darstellung einer Trennlinie zwischen Menu- und Client-Window 


Erzeugung eines virtuellen Sheets (nur QS-PM) 


Tabelle 4: Die unterstützten Class-Styles 


Beispielsweise erhält jedes Window nach der 
WM_CREATE-Nachricht eine WM_COLOR-Nachricht, 
die, falls sie ausgewertet wird, zur Farbkonfiguration des 
betreffenden Windows oder der gesamten Klasse herange- 
zogen werden kann. In ähnlicher Weise erhalten die Parent- 
bzw. Owner-Windows eines Menüs oder einer Message-Box 
vor der Darstellung derselben eine WM_COLOR-Nach- 
richt, wobei der Wert von mp1 darüber entscheidet, ob ein 
Window, ein Menü oder eine Message-Box der Absender 
der Nachricht ist (siehe Programm DEMO.C in Listing I). 


Class-Styles 


Die vom OS/2-PM benötigten Class-Styles sind zum 
größten Teil implementiert worden, wie man der Tabelle 4 
entnehmen kann. Die Class-Styles CS_SIZEREDRAW, 
CS_MOVENOTIFY, CS_CLIPSIBLINGS, CS_CLIPCHIL- 
DREN und C$_PARENTCLIP sind immer aktiv und zur 
Zeit nicht zu unterbinden. Die standardmäßige Einstellung 
der Styles 


CS_CLIPSIBLINGS ı 
CS_CLIPPARENT 


CS_CLIPCHILDREN | 


hat den Vorteil, daß die Integrität der einzelnen Win- 
dows in jeder Lage gesichert ist und es nicht zum Über- 
schreiben anderer Windows durch eine falsch gewählte 
Clipping-Logik seitens des Entwicklers kommen kann. Dies 
gilt insbesondere bei der Definition von mehreren Child- 
Windows und ihren Abkömmlingen. Die Clippingflächen 
sind im QS-PM der Geometrie des Textbildschirms ange- 
paßt, das heißt alle Clipping-und Update-Bereiche sind 
rechteckig. Ähnlich verhält es sich bei den Styles 
CS_SIZEREDRAW ! CS_MOVENOTIFY 

die bewirken, daß automatisch nach jeder Änderung der 
Größe eines Windows vom PM ein Aktualisierungsbefehl 
an die davon betroffenen Windows der Applikation 
geschickt wird (CS _SIZEREDRAW). Der Style CS_ 
MOVENOTIFY bewirkt, daß nach einer Veränderung der 
Lage eines Windows, diesem immer eine WM _MOVE- 
Nachricht gesandt wird. 
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AutoSketch 
Zeichnen, Entwerfen und 


Illustrieren mit AutoSketch. 


Von der einfachen Skizze 
bis zum anspruchsvollen 
Dokument 


Vom einfachen Skizzieren über 
das Anlegen und Verwalten von 
Symbolbibliotheken bis hin zu 
textlich und graphisch auf- 
bereiteten Dokumentationen 
werden in diesem Buch alle 
Anwendungsmöglichkeiten von 
AutoSketch beschrieben. Der 
stufenweise Aufbau und die ver- 
ständliche Darstellung machen 
Vorkenntnisse nicht erforder- 
lich. 


1988, 264 Seiten. 
Geb. DM 48,-/Fr. 48.-/ 
$374,- 

ISBN 3-88322-229-1 


IWT Kompakt: MS-DOS 
Die Befehlsbibliothek 
aller MS-DOS-Komman- 
dos bis Version 3.3 


Das Buch ist als alphabetisch 
geordnete Befehlsbibliothek 
aller internen und externen 
MS-DOS-Kommandos konzi- 
piert, Jedes Kommando wird 
detailliert behandelt und neben 
der Erläuterung von Funktion 
und Syntax mit Beispielen dar- 
gestellt. Für Einsteiger und pro- 
fessionelle MS-DOS-Anwender. 


1988. 248 Seiten. 
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$296,- 
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WordPerfect 
Beispiele-Übungen- 
Befehlsübersichten 


Eine Übersicht über die vielfälti- 
gen Möglichkeiten von Word- 
Perfect. Die Grundlagen (z.B. 
Erfassen, Kopieren, Formatie- 
ren) werden ebenso ausführlich 
beschrieben wie die Sonder- 
funktionen (2.B. Rechenmög- 
lichkeiten, Rechtschreibprü- 
fung, automatische Index- 
erstellung). Durch die Untertei- 
lung aller Kapitel in einen 
Übungs- und Nachschlageteil 
für Einsteiger und fortgeschrit- 
tene Benutzer von WordPerfect 
eine wertvolle Hilfe, 


1988. 280 Seiten. 
Geh. DM 58,- / Fr. 58.-/ 
$452,- 

ISBN 3-88322-206-2 
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Fortran für PCs und Groß- 
rechner 177 - Fortran 77 

- MS-Fortran 

Für alle Rechner mit dem 
Betriebssystem MSDOS, 

CDOS oder UNIX. 


Inhalt des Buches ist die kom- 
plette Sprachbeschreibung von 
Fortran 77 sowieeinSprachver- 
gleich der Betriebssysteme MS- 
008, C-DOS und UNIX. Der 
2. Teil geht dann auf alle not- 
wendigen Compiler wie auch 
auf die Zusatzprogramme rat- 
for, efl, fsplit, etc. ein. 


1988. 616 Seiten. 

Geb. DM 78,-/ Fr. 78.- / 
5608,- 

ISBN 3-88322-180-5 


Kürzbeschreib, 
ne andos, Dienst; 
MSIDOS 


'ng aller 

'Progra 
Omponenten Bel En 
und 


MSDOS im Detail 3 
Kurzbeschreibung aller 
Kommandos, Dienst- 
programme und Kompo- 
nenten von MSDOS 3.30 
und 3.31 


Beschreibung aller externen/in- 
ternen Kommandos vonMSDOS 
3.30, der wichtigen Dienstpro- 
gramme (Debug) sowie aller 
Interrupts und Systemfunktio- 
nen. Einbesonderes Kapitelbie- 
tet alle wichtigen Informationen 
zu MSDOS 3.31 (Compaq Desk- 
pro 386-Version). Ein Standard- 
werk für Software-Anwender 
und Systemspezialisten. 


1988. 584 Seiten, 

Geb. DM 78,-/Fr. 78.-/ 
S608,- 

ISBN 3-88322-203-8 


Das Thema Computer braucht ein tägliches Update. Denn neue Betriebssysteme, 
neue Software-Versionen, neue Anwendungsmöglichkeiten, neue Programmiertech- 
niken, neue Aspekte, Themen und Tendenzen sind in der Computerbranche an der 


Tagesordnung. 


Wer damit zu tun hat, muß deshalb immer up-to-date sein. Mit iwt-Computer-Fach- 
bücher ist das kein Problem: UInsere Bücher kommen aus der Praxis und unsere 
Autoren sind vom Fach: Praktiker mit Berufserfahrung, Fachwissen und Sachverstand. 

Das garantiert zwei wichtige Dinge: Die fundierte Information zu einem aktuellen 
Thema. Sieben von über 20 neuen Titeln sehen Sie hier. Jetzt heißt es „Hands on“: 
Fordern Sie unseren Neuheitenprospekt an. Oder holen Sie ihn sich in Ihrer Buch- 


handlung. 


IWT Verlag GmbH, Vaterstetten - Der Fachverlag für Information, Wissenschaft, Technologie 
Wendelsteinstraße 3, 8011 Vaterstetten, Telefon (08106) 31017, Telex 5213989 iwt 


AUSLIEFERUNG SCHWEIZ: THALI AG, Buchhandlung und Verlag, CH-6285 Hitzkirch, Telefon (041) 852828 
AUSLIEFERUNG ÖSTERREICH: ERB-VERLAG Ges. m.b.H.+Co.KG., Amerlingstraße 1, A-1061 Wien 6, Tel. (0222) 5870526, Telex 136145 


UNIX-Werkzeuge unter 
MS-DOS 

Die UNIX-artige Benutzer- 
oberfläche unter MS-DOS 
und PC-DOS-Systemen 


Dieses Buch gewährt Einblick in 
die Gemeinsamkeiten von UNIX 
und MS-DOS in bezug auf Ein- 
platzsysteme, Es zeigt die Ent- 
wicklung wesentlicher Unix- 
funktionen (Is, man, mv, rm, tail, 
usw.) und deren Integration zu 
einer UNIX-artigen Komman- 
dooberfläche unter MS-DOS. 
Nützliche Unix-Werkzeuge ste- 
hen dem PC-Anwender somit 
zur Verfügung. 


1988. 367 Seiten. 

Geb. DM 58,-/Fr.58.-/ 
$452,- 

ISBN 3-88322-219-4 


Buch und 
IWT-SOFTPAC 
UNIX-Utilities für 
MS-DOS: 

DM 156,-/Fr. 156.-/ 
$1.217,-* 

Best.-Nr. 92231101 


Netzwerkprogrammie- 
rung in dBase Ill plus, 
Clipper und COBOL. 
Planung, Organisation, 
Programmierung. 


Dem Buch liegt ein praktisches 
Projekt zugrunde, das in dBase 
Ill plus und in Clipper entwickelt 
wurde. Es befaßt sich mit der 
Planung und Organisation des 
Netzwerkes und der zu erstel- 
lenden Software, mit der Pro- 
grammierung und dem Testen 
des Netzwerkes und der Soft- 
ware. 


1988. 296 Seiten. 
Geb. DM 68,-/Fr. 68.-/ 
$530,- 

ISBN 3-88322-184-8 


Dazu Diskette 
lieferbar: 

DM 98,-/Fr. 98.-/ 
S764,-* 

Best.-Nr. 92431101 


* unverbindliche Preisempfehlung 


Computer-Fachbücher, 
die weiterhelfen. 


DOS und OS/2 


Window mit einfacher Umrandung 

Erzeugung eines vertikalen Serollbar- Windows 

Erzeugung eines SOTORL0R Scerollbar-Windows 

euren, des ha perpei 

VurpeEEe -& Ierkleinerungsfeikt tion 
rorößerung- ‚, Verkleinerungs- & Iconfunktion 

ei lung eines Applikationswenus 


‚STANDARD 
FE TITLERARI CF SYSMENJ | FCF_MEWU | FCF_SIZEBORDER | FCF_MINMAX 


Window ist von einem Rahmen zmiaen (95-PH) 
Window mit Iter Lenker 


Umrand ne 
ars einer Accelerator-Tabelle 
HCLOSED 


FS_BORDER| 


Tabelle 5: Die unterstützten Window- & Frame-Styles und 
Frame-Flags 


Bei den Styles CS_FLASHFRAME, CS_OWNCOLOR, 
CS_MENUSEPARATOR und CS_VIRTSHEET handelt 
es sich um Styles die im OS/2-PM nicht zur Verfügung ste- 
hen. CS_FLASHFRAME bewirkt bei der Aktivierung eines 
Windows ein kurzes Aufblinken der Umrandung dieses 
Windows. CS_OWNCOLOR erzeugt den oben schon 
erwähnten, zum jeweiligen Window lokalen Farbraum und 
CS_MENUSEPARATOR bewirkt die Darstellung einer 
horizontalen Trennlinie zwischen dem Client- und dem 
Actionbar-Window eines Standard- bzw. Frame-Windows. 

Der Style CS_VIRTSHEET hingegen ist ein Tribut an 
die virtuellen Features der bislang am PC-Markt erhält- 
lichen Window-Manager und erleichtert die Anpassung 
damit entwickelter Applikationen an den OQS-PM. 
CS_VIRTSHEET bewirkt die Erzeugung eines Speicher- 
bereiches mit n Spalten und m Zeilen, auf den mit 
GpiCharStringAt() zugegriffen wird. Der Unterschied 
besteht darin, daß der mit GpiCharStringAt() ausgegebene 
Text auf dem virtuellen Bereich gespeichert ist und das am 
Ende einer Zeile einen Zeilenvorschub und ein Auto-Scroll 
beim Überschreiten der letzten Zeile stattfindet. Zudem 
wird die WM_PAINT-Nachricht bei Windows mit Style 
CS_VIRTSHEET von der Funktion WinDefWindowProc() 
selbstständig verarbeitet, so daß das Schreiben einer eige- 
nen Paint-Funktion entfällt. Die Ausdehnung dieses Sheets 
in horizontaler und vertikaler Richtung wird vom Rück- 
gabewert der WM_CREATE-Nachricht festgelegt. 


Window- und Framestyles 


Von den für den Applikationsprogrammierer wichtigen 
Window- (WS _*) und Frame-Styles (FS_*) und Frame- 
Flags (FCF_*) werden die in der Tabelle 5 aufgelisteten im 
Sinne des OS/2-PMs unterstützt. 

Eine Besonderheit stellt der Frame-Style FS_EN- 
CLOSED dar. Je nach Wahl des Videomodus hat eine 
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Applikation im Textmodus zwischen 80 bis 132 Spalten und 
25 bis 60 Zeilen zur Verfügung, eine, verglichen mit der 
grafischen Variante, deutlich geringere Auflösung. Da in 
den meisten Fällen das Client-Window des Frame-Windows 
zur Ausgabe von Information benutzt wird, reduziert sich 
die maximale auf dem Bildschirm sichtbare Höhe im 
ungünstigsten Fall um weitere fünf Zeilen für Umrandung 
(unten & oben), Titlebar-, Actionbar- (oben) und Scrollbar- 
Window (unten). Durch die Benutzung des Frame-Styles 


FS_STANDARD & “FS_ENCLOSED 


entfällt die explizite Umrandung des Frame-Windows, 
da Titlebar- und Scrollbar-Windows auf der Umrandung 
selbst dargestellt werden und so zwei Zeilen und Spalten 
gewonnen werden. 

Von den Controls des Frame-Windows stehen dem 
DOS-Programmierer die Titlebar-, die vertikalen und hori- 
zontalen Scrollbar-, die Action-Menu-, die System-Menu-, 
die Sizebox-, Sizeborder- und die Minmax-Control zur 
Verfügung, deren Funktionsumfang zu dem vom OS/2-PM 
identisch ist. 


Die Tastatur-, Timer- und Mausschnittstelle 


Neben der Aufrufkonvention der Bildschirmfunktionen 
geben häufig auch die Tastatur- und Mausschnittstellen 
Anlaß zur mangelnder Portabilität. Nicht so beim QS-PM, 
der sich hierbei praktisch vollständig kompatibel zum OS/2- 
PM verhält. Die Tastaturschnittstelle der Applikation wird 
durch die WM_CHAR-Nachricht hergestellt, wobei nur die 
Bits KC_ SCANCODE, KC_LONEKEY, KC_DEADKEY, 
KC | COMPOSITE, KC_ INVALIDCOMP zur Zeit nicht 
unterstützt werden. Die Verwaltung der Umlaute, die nor- 
malerweise über die Bits KC_DEADKEY und KC_COM- 
POSITE dekodiert werden, wird im QS-PM zur Zeit mit 
KC_CHAR kodiert, so daß zum Beispiel die Taste »Ä« mit 
dem Wert 142 als ASCII-Erweiterung kodiert ist. Die 
Maus- und Timerschnittstelle hingegen ist 100% kompatibel 
zu der des OS/2-PMs. 


Die Speicherverwaltung 


Die dynamische Speicherverwaltung ist Teil des QuickStep 
Resource-Managers, der die meisten der Hardware- und 
betriebssystemspezifischen Komponenten enthält. Die Spei- 
cherverwaltung ist OS/2-kompatibel und erfolgt somit über 
Handles bzw. Selektoren. Auf diese Weise konnten wir die 
Unterstützung von virtuellem Speicher (Platte) und EMS- 
Speicher vor der Applikation verbergen und portabel 
halten, so daß die Applikationsschnittstelle für MS-Win- 
dows, DOS, OS/2 und UNIX immer identisch und die Allo- 
kationsart über die Konstanten SEG_* kodiert ist. Speicher- 
blöcke die »discardable« (SEG_DISCARDABLE) sind 
oder im EMS-Speicherbereich (SEG_EMS) liegen, müssen 
vor Gebrauch »gelocked« und nach Gebrauch wieder »un- 
locked« werden. 


DOS und OS/2 


Der Resource Compiler 


Wie sein OS/2-Pendant verfügt auch der QuickStep Pre- 
sentation Manager über einen Resource-Compiler zur 
Wartung und Definition von Strings, Menüs und Accelera- 
tors (Dialog-Ressourcen sind zur Zeit nicht implementiert). 
Im Unterschied zum OS/2-PM erzeugt der QS-PM jedoch 
wahlweise C-, Modula-2- oder Pascal-Code, der nachträg- 
lich noch kompiliert werden muß oder eine Datei, die in 
kompakter Form die Ressourcedefinitionen enthält und von 
der Applikation zur Laufzeit geladen werden können. Somit 
entspricht der C-Code-Erzeugung die Option PRELOAD 
und der Dateivarianten die Option LOAD ON CALL des 
OS/2-PM. Diese Unterscheidung war notwendig, da wir das 
DOS-EXE-Format nicht modifizieren wollten. Das Listing 2 
zeigt einen Ausschnitt der zum Beispielprogramm gehören- 
den Ressourcedatei DEMO.RC und Listing 3 die vom 
Ressource-Compiler erzeugte Datei DEMO.RCC. Interes- 
sant ist im Zusammenhang mit den Menüdefinitionen, daß 
der QS-PM auch beliebig geschachtelte Menüdefinitionen 
verarbeiten kann. 


Resümee 


Zusammenfassend kann gesagt werden, daß der QuickStep- 
Presentation Manager zur Entwicklung von Applikationen 
unter DOS zum Zwecke der späteren leichten Portierung 
nach OS/2 und UNIX entwickelt wurde. Da in der DOS- 
Version keinerlei grafische Unterstützung zur Verfügung 
steht, dürften die meisten damit geschriebenen Applikatio- 
nen mit dem OS/2-Presentation Manager unverändert lau- 
fen. Der umgekehrte Weg eine vollständige OS/2-PM 
Applikation mit ausgeprägter Grafikschnittstelle unter DOS 
mit dem OS-PM laufen zu lassen, dürfte einige Modifika- 
tionen am Programm erfordern. Die bislang fehlende 
Unterstützung von Dialogboxen und Clipboardfunktionen 
soll bis zum Herbst 1989 nachgeholt sein. In dieser Version 
dürfte der QS-PM eine echtes Argument zur Entwicklung 
von den Microsoft Presentation Manager unterstützenden 
Anwendungen sein, da dann für die wichtigsten Betriebs- 
systeme DOS, OS/2 und UNIX sowohl eine Grafikschnitt- 
stelle (OS/2 und UNIX), wie auch eine Textschnittstelle 
(DOS und UNIX) zur Verfügung steht und somit Portabili- 
tätshemmnisse nicht mehr vorhanden sind. 

Rainer Wallwitz 


Der Autor ist Geschäftsführer der Fa. Lauer & Wallwitz 
GmbH und dort für die Entwicklung von MS-Windows-, 
OS/2- und Presentation-Manager-Tools und Applikationen 
verantwortlich. Das beschriebene Produkt QuickStep Presen- 
tation Manager kann auf der CeBIT 89 am Stand von Lauer 
& Wallwitz (Halle 6, Stand H20, direkt gegenüber von 
Microsoft) besichtigt werden. 


jemenumenuunneen EEE EI EZ 


® DEMO.C: Demonstrationsprograms der QuickStep Presentation-Hanager 
® DB) otbal für 005 

® €) Copyright LAUER & WALLWITZ, 

% 200 Wiesbaden, m, ‚Kirchgasse 24 24, ‚Tel, 06121 / 30 10 65 
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#include <qrmodel .h> 
Hinclude <string.h> 
#include *appli.h" 


HWND, USHORT, MPARAM, RAN; 
in, USWORT, EN. NPÄRAN ):; 
„ MPARAM, MPARAN ); 


MRESULT EXPENTRY ClientWndProc 
MRESULT EXPENTRY ClientChi] Proc 
MRESULT EXPENTRY WndProc( HWND, U 


static void isterClasses( vo; 
static void Eitanthainel Lu Yesok, USHORT ); 


static void ChildPaint( HPS }; 


static PSZ Sheet[] = ( 


1 
static usSheetlines = 31; 


static PSZ pszClientClasshame CLIENT"; 
static PSZ PszClientchildclasshane = ” CH; H 
static PSZ pszframe2Classhame "FRAME2*; 
static char Guithuffer 50]; 

static char TermBoxBuffer 50]; 

static HAB hAB; 


feet ein rennen“ / 


SG re 
Vsnorr Kelle) ce; 
BOOL : 


ULONG flFramerlags = "rer MINMAX Be: FCE VE scRotı I FCF_HORZSCROLL | 
FCF_SYSMEM) 


je Wintergrundzeichen und -attribut setzen */ 

MinCustomizeQS( CUST /* Micht 0S/2-PM kompatibel ef: 
wu 0" BACKGROUND, 

WinCustomizeQs( MACTLOR a “ 

inCustomiz ” 
cusT” 


elsiermg des 80x43 Zeilen-Modus (EGA) Bf 
MODE, licht SR: PM kompatibel 
vIo EGA T VIO-COLOR I vo. 80_a3*/ 


PR IntElalislaren „ 


hAB = WinInitializel); 
I" ah Queue erzeugen */ 


hMQ = WinCreateisgQueue( hAB, O ); 


/* Ressource-String IDS WANT QUIT laden */ 
WinloadString( hAB, WILL, 1D5_| _WIT, 50, QuitBuffer ), 


10S_TERMBOX laden */ 


/* Ressource-Stri 
40, TermBoxBuffer ), 


WinloadString( hAB, NULL, IDS_TERMBOX, 


/* Window-Klassen registrieren */ 
RegisterClasses(); 


/* Frame-Window kreieren Be 
hfFrame = ker 
HISIRLE I FS/BORDER | ES Dlasomen | Fi SIZEBORDER | 
For 7° nicht 0S/Z-PM Kompatibel. "zusätzlich % 
ArtErsnerlag s, 
Baiien ientC] Gssllame: 
CKSTEP - TOOLS”, 
f 
MWULL, 
10M_APPLMENU3, 
AhlTient ); 


I" Message-Loop */ 
ef ( !lfContinve-WinGetlsg(hAB,äMsg,WLL,0,0)) ) { 


/* Messagebox aktivieren und fra ob Program Bes: werden soll */ 
usChoice-WinhessageBox( ” ET HWND_DE 
Teradonbutter, 


OKCANCEL | MB_DEFBUTTORZ ); 
fContinue = (usChoice == Rune 0x.) ? "FALSE : TRUE; 


else WinDispatchMsg( hAB, Alsg ); 
} while( feontinue in ” 


/* Frame EHRdON zerstören 
Windes tropinde h Frame ); 
windestropfsgduene (RE 
inDest ; 

Ir m „na mens hl 
WinTerminate( hAB ); 

return 0; 


Listing 1: DEMO.C 
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[r=* ClientkndProc Trrreremenennnneannennnnennnnenennn en nenne nee / 


MRESULT EXPENTRY ClientWndProc( hund, message, aram] „ aram2 
ur { ge, app: app: ) 


zsnnr message; 
MPARAM mpParaml ,mpParam2; 


ULONG Fiiranerlags; 
static USHORT usLow,usHigh; 
static HWND hframe,hClient; 


switch( message ) 


case WM COLOR : /* Farb- Br st a Ballon: nur QS-PM */ 

PCOLORSTRUCT plolor = DLORSTRUC 

if \ LOUSHORT ER .- SER En 
* Installation des Window 
pColor->yActiveßorder . 
pColor->yInactiveßorder Ri 
pColor->wActiveCaption = 0x1820; 
pColor->wInactivelaption = 0x1820; 
pColor->yActiveCaptionlext = 112; 
KESlor->ylnnehiN ptionlext = i 
pColor->usßac le = 0x0720; 
pColor->bSysCtlAttr - 112; 
pColor->bMinMaxCtlAttr “112; 
pColor->CTL.pSerl->yVThumbAttr = Oxlf; 
pColor->CTL.pScrl->yHThumbAttr = Alf: 
pColor->CTL.pScrl->yVBackAttr = Ox17; 
pColor->CTL.pScrl->yHBackAttr = Ox17; 
PColor->CTL.pScrl->yScriVBoundAttr = Oxlf; 
pColor->CTL.pSerl->yScrlHBoundAttr = Oxif; 


} 
else H ( LOUSHORT(mpParaml) == an Br JA 
Installation einer Messa 
pMBCo] ->bHeaderA ng af; 
pen? ->bframeAttr - 2; 


ER 


case WH_CREATE 
WinQverykindowRect( hind, &rc ); 
uslow = 0; 
en "rc. rn yTop+l; 


ee des Frame-Windows, d.h. des Owners umsetzen 
binse ee. OWNER, FALSE), 


7 E SIZE | SWP_MOVE ); 


/* eine weiteres Deskt 
flframeflags = FCF Tinteh Tre Ki FCF_ Sr ‚fer MEN; 


hframe = WinCreateStdw 
rs. Kir 


FS| ENCHOSEN, RER, nicht 0S/2-PM kompatibel, zusätzlich */ 


&fTframeflags, 
EEeFeSBET None: 
oe ame2-Window", 


IM Appınew1, 
ähllient ); 
break; 


case WM_DESTROY : /" das bei WM_CREATE erzeugte Window zerstören 
WinDestroytindom( hframe ); 


case WM SIZE : /" Höhe des Client-Windows ermitteln */ 
in = usLow+HIUSHORT ( (ULONG)mpParasl); 


case WM_VSCROLL : /* Scroll-Motification auswerten und */ 
/* die Client-Area aktualisieren “ 


switch( HIUSHORT(mpParam2) ) 


case SB_LINEUP 8 
case SB_LINELEFT : 
fl ustw>0) 
usLow--; 
usHigh--; 
WinSendsg (hund, WH_PAIKT.OL,OL); 


break; 
case SB_| LINEDOWN 2 
case e LINERIGHT : 
int usHigh < usSheetlines-1 ) { 
usLowtt; 
usHigh+t; 
irsenstän (nnd. „MM_PAINT,OL,OL); 


break; 
reak; 


case WM_ACTIVA 
rt BIUSROR(LOWG)apParal)oFätse ) return OL; 


den Input-Focus */ 
Wasatfasksl HWND_DESKTOP, hund ); 
break; 


Listing 1: (Fortsetzung) 
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DOS und OS/2 


er. 


“/ 


case WM_COMMAND : 
switch( LOUSHORT((ULONG)mpParaml) ) 


case /* Tersinierung des Programmes 
Kinpesths( hund, WM_QUIT, OL KT = 


case 1DM OPEMWND : /* Öffnen des Frame-Windows 
WinShowkindow( hframe, TRUE ): 
NN hframe ); 


case IDM_CLOSEWND : /* Schließen des Frame-Windows 
WinShowttindom( hFrame, FALSE ); 
break; 
ki 
case WM PAINT : /* Client-Paint Funktion 
hPS = WinBeginPaint( hWnd, MULL, MWLL ); 
ClientPaint| hPS, usLow, ah): 
WinEndPaint( hPS ); 
break; 


default : return WinDefWindowProc( hund, message, mpParaml, mpParam2 }; 


green Ol; 


/"** ClientChildWndProc ee 


MRESULT EXPENTRY ClientChildWndProc( hund, message, mpParam! „ mpParan2 ) 
HWND hund; 


USHORT message 
MPARAM eererual) mpParam2; 


HPS hPS; 
m tch( message ) 


case WM_CREATE : 


/" aktuelle Farbe auf Attribut 112 setzen */ 
/* nicht 0$/2-PM kompatibel -/ 


WinSetTextColorQS( WinGetPS(hWnd), 112 ); 
break; 


case WM_COLOR : /* Farb- und Stylekonfiguration, nur QS-PH “ 


if KO it ULONG)mpParaml) == COLOR_WND ) ( 
olotons Boch eteler - (pcoLdr STRICH Para 
PS ste 
pColor->wActiveCaption = 911830; 
pColor->wInactiveCaption = 0x1820; 
pColor->bMinMaxltlAttr = 112; 


ki 


case WM _PAINT 
hP5 = = Nindeginpaint( hiind, MULL, WILL ); 


/* Window-Rechteck mit WinFillRect mit 0x7020 fuellen */ 
/* Wert des letzten Parameters nicht 0$/2-PM kompatibel */ 


WinFillRect( hPS, WILL, 0x7020 ); 
ChildPaint( hPS j; 
WinEndPaint( hps }; 
break; 


aaa : return WinDefWindowProc( hWnd, message, mpParaml, mpParam2 ); 


ch ol; 


["®® UndProc "Trmeeeeenneeennnannnennunnnenennennnnennn nenn nenn / 


HRESULT EXPENTRY WndProc( hund, message, mpParaml , aram2 
gi ( ge pP ) 


USHORT message 
MPARAM Saral; wpParam2; 


HPS hPS; 

ULONG flFrameflags; 

static HWND hframe,hClient; 
switch( message ) 


case WM_CREATE : 
je aktuelle Zeichenfarbe setzen */ 
/* nicht 05/2-PM kompatibel “fi 
WinsetTesteoloröst BUNG) ER 
Frame-Window al Child-Wi des Clients a zw! 
fIframeflags = FCF_MINMAX | FCF_VERTSCROLL | FCF_HORZSCROLL 
FCFSYSMENU Mn s 
hFrame = WinCreateStdWindow 


s_DL $_SIZEBORDER 

FSTENCLOSED, 1% nicht 05/2-PM Ikonpatibel, zusätzlich */ 
&fTFrameflags, 

gezClientChiläclasahne, 

Rn 1d-Windom' 


MLL, 
10M ÄPPLMENU2, 
ShlTient ); 


Listing 1: (Fortsetzung) 
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case WM_DESTROY 
MiiDestroyindn( hfFrame ); 


case WM COMMAND : 
giec LOUSHORT((ULONG)mpParaml) ) 


case IOM OPENCHILD: /" Öffnen des Frame-Windows Y. 
WinShowWindow( hFrame, TRUE ); 
ern hframe ); 


case IDM CLOSECHILD: /" er des Frame-Windows */ 
winShowWindow( hFrame, FALSE ); 


reak; 


case WA_COLOR : /* Farb- und Stylekonfi wide nur QS-PH */ 
a LOUSHORT (ULONGJapParanl) = == COLOR_WND ) { 
plolor = a STRVCT)apParan2; 
pColor->wActivelaption = 
pColor->wInactivelaption = Onaeo: 


ki 


case WM _PAINT 
hPS = = Kinßeginpaint( hund, MÜLL, WILL ); 


/* Window-Rechteck mit WinFillRect mit 0x2020 fuellen */ 
/* Wert des letzten Parameters nicht 0S/2-PM kompatibel */ 


LEN hPS, MWLL, 0x2020 ); 
ChildPaint PS j; 
WinEndPain ers}; 


default : 
Fokl WinDefWindowProc( hund, message, mpParaml, mpParam2 ); 


aaa OL; 


/"** ClientPaint *mmmeemunnnnnmennenunnennneennenentnnnnnennnunnnen/ 


„utie void ClientPaint( hPS, usL, usH ) 
USHORT usL,ust; 


USHORT ushdx = usl; 
POINTL Pt; 


uh = abensSbnaekines) ? usH : usSheetlines; 
Pr.x = Pt.y = 0; 
for (ushdx=usL; usNdx<usH; usNdx++ 
Gpicharstringat( hPS, äPt, 70L, Vleerfusnax) » 
y+t; 


je" ChildPaint be bh ehe a kin ha 
static void ChildPaint( hPS ) 
HPS hPS; 


(user ushdx; 
POINTL Pt: 


Pt,x = 
Ei: usNdx<usSheetlines; ushdut+) ( 
” USMdX- 
Coifharstringäe] HS, apt, 70L, Sheet[usidi] ); 


/*** RegisterClasses "rrrrerenanenennennnrannnennenantennrenneeenneen/ 


static void RegisterClasses() 


WinRegisterClass( hAB, 
zClientClassName, 
lientWndProc, 
650 DEFAULT | cs ;_OWNCOLOR, /* Klasse mit eigenem Farbraum "/ 


WinRegisterClass( hAB, 
zClientChildClasshame, 
lientChi ldWndProc, 
CS DEFAULT | CS_OWNCOLOR, /* Klasse wit eigenem Farbraum "/ 


WinRegisterClass( hAB, 
2. | zfranezClasshane, 


I* Klasse ohne eigenen Farbraum */ 
Ger, 


Listing 1: (Ende) 


P Ilichiebebeieheheleinlehslslahsislbslehshnlieieheielehsialahleieiniehsishehslelahehehslekshehele kulebebelehuhelchelehehahaledetelehehelshnlale) 
” 


DEMO.RC 
" Ressourcedatei des Programs DEMO.C 
DEI EI EI E22 


w.... kai eleieieieheleiebuielehsiaheliahaieiekeleknieiehteiaieieiehteinstebeheteheheteine] 2 


MODULE InstallResources0S 
BEGIN 


Finclude <qspw.h> 
#include DE h* 


CODE #include <appli.h> CODE END 
STRINGTABLE DemoStrings 


sh en AUT "po you want to terminate this demonstration ?\n" 
jICTENME Termination Box" 


MENU "Applikationsmenul*, ApplMenultems, IDM_APPLMENU] 


STYLE HORIZONTAL 
MENUITEM ""Offne Child” ,  IDM_OPENCHILD 
zum eSchliesse Child*, IOMLCLOSECHILD 


MEN) *Applikationsmenu 2*, ApplMenultems2, 1DM_APPLMEN2 


STYLE HORIZONTAL 
ME! 10M_CREATE 
en 


10M-DELETE 
ME ; ION-SNITCH, MIA_DISABLED 
(AmBEREN et = „ IOMZAPPEND, MIA_DISABLED 


MEN) "Applikationsmenü 3", ApplMenultems3, IDM_APPLMENI3 


STYLE HORIZONTAL 
MENUITEM en öffnen" . 1DM_OPENWND 
MENUITEM *"Schließen", 10M_CLOSEWND 


SUBNEN) *Autolenu*, Autollenu, IDM_AUTOHEN), IDMLAUTO 


YLE VERTICAL 
TITLE TOP "CARS 
MENUIT! 


ITEM "BMW", 
MENUITEM UHERCEDES BENZ”, 
MEWITEM "OPEL" 
NENUITEM "AUDI", 
MENUITEM "PORSCHE", 
von EM "FORD", 


SUBMEN) "ComputerMenu”, ComputerMenu, IDM_COMPUTERMENU, IDH_COMPUTER 


TYLE VERTICAL 
TITLE En 

MENUIT! 

MERULTEN ze 


SUBMEN) "BankenMenu", BankenMenu, IDM_BANKENMEWU, IDM_FUJITSU 


TYLE VERTICAL 
Die TOP "Gersan Bank: 

MENUITEM ""Commerzbank 1DM_CBANK 
MEWUITEN *"Deutsche Banke, 1OM_DTBANK 


SUBMEW) "StadtMenu*, StadtMenu, IDM_STADTMEM), TIDM_DRBANK 


TYLE VERTICAL 
TITLE TOP *Cities” 
MEWUITEM “Hamburg”, IDM_HKAMBURG 
NENUITEM ""Dortmund”, IOM-DORTHURD 
MEWUITEM „Wiesbaden“ . IONCWIESBADEN, MIA_CHECKED 
in OMTHAINZ 


I 
IDMBERLIN 


r IONCFRANKFURT 

MENUITEM SEPARATOR 

MENUITEM ""München", IDM_MUNCHEN 

MENUITEM *"Hanno”ver", IDM HANNOVER 

MEWIITEM "B“remen", IDM_BREMEN 

neuren "Hypo Bank", 

MENUITEM °"DEC”, I0M_DEC 
MEWUITEM ""SUN“, IDMTSUN 
MENUITEM ""APOLLO”, 1DM_APOLLO 


vehunrn *FlugzeugWenu", IDM_FLUGZEUG 
EN "Que . a 10M_WIT 


IDM_HBANK 


ACCELTABLE AccelTablel, 10M_APPLMENI3 


VK_F1, 10M_OPENWND, KC_VIRTUALKEY 
YKFZ. IOWZAPOLLO,  KCZVIRTUALKEYIKC_SHIFT 
3 IOMQIT,. "  KCICHARIKC_ALT 


End 
Listing 2: DEMO.RC 
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DOS und OS/2 


static PSZ DemoStrings[] = ( 
“ you want to terminate this demonstration ?\n", 
ermination Box", 


static MENUITENTENPLATE AopWenultams ] -({ 
"öffne Child" , MULLH, MIS STRING 
""Schliesse Child”, WLLH, MIS STRING 
ML „ MÖLLH, MS_HORTZONTAL 
MLL SWLLH, 0 


’ 


static MENIITENTENPLATE Aopfenaltemsz[] -({ 

“Create” Mur, his STRING 
} WOLLH, MISTSTRING 
Lin NISZSTRING {ION DELETE 
& MILLH, NIS-STRING /NIA_DISABLED, TOR SWITCH 
; Mh, MIS7STRING|MIATDISABLED, LOM”APPENO 
I NULL, MS_HORIZONTAL „MENUT 
I SLCH, 0 IMENUTLASTENTRY } 


DM_OPENCHILD „NULLH 
"TOR-CLOSEcH [0] 


IMENÜ_END : 
SMENUTLASTENTRY , 


static BEWETENUENEERTE wre -{ 
MERCEDES BENZ*, „wu, A STRING 
“OPEL” LIH, MIS_STRING 


WLLK: nis STRING 


N 
« MILLR, IS STRING 

! NULLH, MS_ VERTICAL H 

; NULLK, nis TOPTITLE 0 MU 
; MLLK, INENU_LASTENTRY 


h 
static NEWITEMTENPLATE Stadtiienu -{ 
"Hambu 


rg” WLLH, „10m Be 
"Dortmund MULLK, nis“ STRING „LOMDORTMU 
"Wiesbaden" WULLH, MISISTRING|NIA_ CHECKED, LONCNIESBADEN 
"Mainz" . W MISTSTRING „LOMTMAINZ 
"Berlin" „ WLLH, „IOM-BERLIN 
BEIELBRNIOLE! "Ion ERANKEURT 


""Yünchen“ . Ion MUNCHEN 


“Hanno” ver" „TOMTHANNOVER 
"Bremen" . NULLK, MISTSTRING „IOMBREMEN 
WILL, WULLK, MS VERTICAL IMEND_END 
"Cities" WLLK, as TOPTITLE ‚Oo . 
MWLL NULLK, „MEMU_LASTENTRY „ 
; 


static MENUITEMTEMPLATE BankenMenu[] = ( 
"Commerzbank" „ MLLH, MIS_STRI 
"Deutsche Bank", „auch, MIS_STRING 
"StadtMenu” » „ MIS_SUBMEN) 
: Mila, MIS"STRING 
« MULLR MS_VERTICAL 
Kis. TOPTITLE 


DM_CBANK 
:DNCDTBANK 
„ IONTSTADTMENU 
IM HBANK 
NEE END 
} Wem. LASTENTRY 


static MEWITENTEMPLATE terMenu[] = { 
"COMPAQ" „ MWLLH, MIS_STRING 
E NULLH, MISISTRING 


„IDM_COMPAQ 

„IOMZ18M „MULL 
„IOM-BANKENMENU ,„ 
„ION-DEC ML 
„TOM SUN 

; NULLH, MIS- ER „IOMAPOLLO 

„ MLLH, MS_VERT „MENJ_END 


} MLLH, nis TOPTITLE ‚0 / 
! ULLK, IMENU_LASTENTRY 


static WER TTEBENGEETE a -{ 
""Offnen S_STRING „T0M_OPENWND 
tin MIS/STRING Ion“ TCLOSEWND "ulın 
MLLH, MER SUBMENU DMTAUTOMENU TOM AUTO 
H 3IO Coneuemeni, 2 COMPU 
DMTFLUGZEUG 


ZIOM-QULT ir! 
MO_END SMULLH 
IMEMJTLASTENTRY \MULLH 


static ACCELITENSTRUCT AccelTablel 
YK OPENWND , KC_VIRTUAL ; 
} KCZVIRTUALKEY IKC_SHIFT |, 
[ ! KEICHARIKC_ALT R 
YKWLL, 0 . ot 


void APIENTRY a enas Li, 
InsertMenuResourc StadtMenu, IDM ST 
InsertStringTab] Destrings, 1 
InsertMenuResourc 
InsertMenuResourceQS Serlackene 
InsertfenuResourceüs| Autollenu, "04 ADTOMEm) 
ni a enhae App!Menultems2, I0M Apolie 

sertMenuResou' IMenultems3, RE kerinn 
ImertaccelTableüs ccelTablel, I0M APP rk 
InsertMenuResourceüS( Comput. erfenu, Tom Eve mw x 


ADTNER) ); 


Listing 3: DEMO ..RRC 
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CAM, CAP oder CAE gehörenschonzum Sprachgebrauch 
invielen Branchen. Denn immer mehrwerden diese Tech 
niken auch auf Computern einsetzbar, die jedermann nut- 
zen kann: Auf Personal Computern und Workstations. 

Konstruieren und Entwickeln per Computer, Zeichnen 
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Magazin, das sich speziell mit den „C’-Techniken auf Per- 
sonal Computern und Workstations beschäftigt. Und das 
deshalb ganz speziell und detailliert auf diese Thematik 
eingehen kann. 

Wer von Berufs wegen dieses Thema im Auge haben 
muß, istmitdem AUTOCAD-Abonnementautomatischim 
Bilde. Denn’ es ist ein Abonnement auf wichtige und 
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